Matthias Andreas Benkard | 31c61e7 | 2021-12-16 20:06:39 +0100 | [diff] [blame] | 1 | package eu.mulk.jgvariant.core; |
| 2 | |
Matthias Andreas Benkard | 25b7f90 | 2021-12-17 06:02:11 +0100 | [diff] [blame] | 3 | import org.apiguardian.api.API; |
| 4 | import org.apiguardian.api.API.Status; |
| 5 | |
Matthias Andreas Benkard | 31c61e7 | 2021-12-16 20:06:39 +0100 | [diff] [blame] | 6 | /** |
| 7 | * A dynamically typed GVariant value carrying a {@link Signature} describing its type. |
| 8 | * |
| 9 | * <p>{@link #value()} can be of one of the following types: |
| 10 | * |
| 11 | * <ul> |
| 12 | * <li>{@link Boolean} |
| 13 | * <li>{@link Byte} |
| 14 | * <li>{@link Short} |
| 15 | * <li>{@link Integer} |
| 16 | * <li>{@link Long} |
| 17 | * <li>{@link String} |
| 18 | * <li>{@link java.util.Optional} (a GVariant {@code Maybe} type) |
| 19 | * <li>{@link java.util.List} (a GVariant array) |
| 20 | * <li>{@link Object[]} (a GVariant structure) |
Matthias Andreas Benkard | b50fcd0 | 2021-12-16 20:17:20 +0100 | [diff] [blame] | 21 | * <li>{@link Variant} (a nested variant) |
Matthias Andreas Benkard | 31c61e7 | 2021-12-16 20:06:39 +0100 | [diff] [blame] | 22 | * </ul> |
| 23 | * |
| 24 | * @param signature the signature describing the type of the value. |
| 25 | * @param value the value itself; one of {@link Boolean}, {@link Byte}, {@link Short}, {@link |
| 26 | * Integer}, {@link Long}, {@link String}, {@link java.util.Optional}, {@link java.util.List}, |
Matthias Andreas Benkard | b50fcd0 | 2021-12-16 20:17:20 +0100 | [diff] [blame] | 27 | * {@link Object[]}, {@link Variant}. |
Matthias Andreas Benkard | 31c61e7 | 2021-12-16 20:06:39 +0100 | [diff] [blame] | 28 | */ |
Matthias Andreas Benkard | 25b7f90 | 2021-12-17 06:02:11 +0100 | [diff] [blame] | 29 | @API(status = Status.EXPERIMENTAL) |
Matthias Andreas Benkard | 31c61e7 | 2021-12-16 20:06:39 +0100 | [diff] [blame] | 30 | public record Variant(Signature signature, Object value) {} |