Package net.kyori.adventure.nbt
Interface CompoundBinaryTag
- All Superinterfaces:
BinaryTag
,BinaryTagLike
,CompoundTagSetter<CompoundBinaryTag>
,net.kyori.examination.Examinable
,Iterable<Map.Entry<String,? extends BinaryTag>>
public interface CompoundBinaryTag extends BinaryTag, CompoundTagSetter<CompoundBinaryTag>, Iterable<Map.Entry<String,? extends BinaryTag>>
Binary tag holding a mapping of string keys to
BinaryTag
values.- Since:
- 4.0.0
-
Nested Class Summary
Nested Classes Modifier and Type Interface Description static interface
CompoundBinaryTag.Builder
A compound tag builder. -
Method Summary
Modifier and Type Method Description static @NonNull CompoundBinaryTag.Builder
builder()
Creates a builder.static @NonNull CompoundBinaryTag
empty()
Gets an empty compound tag.static @NonNull CompoundBinaryTag
from(@NonNull Map<String,? extends BinaryTag> tags)
Creates a compound tag populated withtags
.@Nullable BinaryTag
get(String key)
Gets a tag.default boolean
getBoolean(@NonNull String key)
Gets a boolean.default boolean
getBoolean(@NonNull String key, boolean defaultValue)
Gets a boolean.default byte
getByte(@NonNull String key)
Gets a byte.byte
getByte(@NonNull String key, byte defaultValue)
Gets a byte.byte @NonNull []
getByteArray(@NonNull String key)
Gets an array of bytes.byte @NonNull []
getByteArray(@NonNull String key, byte @NonNull [] defaultValue)
Gets an array of bytes.default @NonNull CompoundBinaryTag
getCompound(@NonNull String key)
Gets a compound.@NonNull CompoundBinaryTag
getCompound(@NonNull String key, @NonNull CompoundBinaryTag defaultValue)
Gets a compound.default double
getDouble(@NonNull String key)
Gets a double.double
getDouble(@NonNull String key, double defaultValue)
Gets a double.default float
getFloat(@NonNull String key)
Gets a float.float
getFloat(@NonNull String key, float defaultValue)
Gets a float.default int
getInt(@NonNull String key)
Gets an int.int
getInt(@NonNull String key, int defaultValue)
Gets an int.int @NonNull []
getIntArray(@NonNull String key)
Gets an array of ints.int @NonNull []
getIntArray(@NonNull String key, int @NonNull [] defaultValue)
Gets an array of ints.default @NonNull ListBinaryTag
getList(@NonNull String key)
Gets a list.default @NonNull ListBinaryTag
getList(@NonNull String key, @NonNull BinaryTagType<? extends BinaryTag> expectedType)
Gets a list, ensuring that the type is the same astype
.@NonNull ListBinaryTag
getList(@NonNull String key, @NonNull BinaryTagType<? extends BinaryTag> expectedType, @NonNull ListBinaryTag defaultValue)
Gets a list, ensuring that the type is the same astype
.@NonNull ListBinaryTag
getList(@NonNull String key, @NonNull ListBinaryTag defaultValue)
Gets a list.default long
getLong(@NonNull String key)
Gets a long.long
getLong(@NonNull String key, long defaultValue)
Gets a long.long @NonNull []
getLongArray(@NonNull String key)
Gets an array of longs.long @NonNull []
getLongArray(@NonNull String key, long @NonNull [] defaultValue)
Gets an array of longs.default short
getShort(@NonNull String key)
Gets a short.short
getShort(@NonNull String key, short defaultValue)
Gets a short.default @NonNull String
getString(@NonNull String key)
Gets a string.@NonNull String
getString(@NonNull String key, @NonNull String defaultValue)
Gets a string.@NonNull Set<String>
keySet()
Gets a set of all keys.default @NonNull BinaryTagType<CompoundBinaryTag>
type()
Gets the tag type.Methods inherited from interface net.kyori.adventure.nbt.BinaryTag
asBinaryTag
Methods inherited from interface net.kyori.adventure.nbt.CompoundTagSetter
put, put, put, putBoolean, putByte, putByteArray, putDouble, putFloat, putInt, putIntArray, putLong, putLongArray, putShort, putString, remove, remove
Methods inherited from interface net.kyori.examination.Examinable
examinableName, examinableProperties, examine
Methods inherited from interface java.lang.Iterable
forEach, iterator, spliterator
-
Method Details
-
empty
Gets an empty compound tag.- Returns:
- an empty tag
- Since:
- 4.0.0
-
from
Creates a compound tag populated withtags
.If
tags
is empty,empty()
will be returned.- Returns:
- a compound tag
- Since:
- 4.4.0
-
builder
Creates a builder.- Returns:
- a new builder
- Since:
- 4.0.0
-
type
Description copied from interface:BinaryTag
Gets the tag type. -
keySet
Gets a set of all keys.- Returns:
- the keys
- Since:
- 4.0.0
-
get
Gets a tag.- Parameters:
key
- the key- Returns:
- a tag
- Since:
- 4.0.0
-
getBoolean
Gets a boolean.Booleans are stored as a
ByteBinaryTag
with a value of0
forfalse
and1
fortrue
.- Parameters:
key
- the key- Returns:
- the boolean value, or
false
if this compound does not contain a boolean tag with the specified key, or has a tag with a different type - Since:
- 4.0.0
-
getBoolean
Gets a boolean.Booleans are stored as a
ByteBinaryTag
with a value of0
forfalse
and1
fortrue
.- Parameters:
key
- the keydefaultValue
- the default value- Returns:
- the boolean value, or
defaultValue
if this compound does not contain a boolean tag with the specified key, or has a tag with a different type - Since:
- 4.0.0
-
getByte
Gets a byte.- Parameters:
key
- the key- Returns:
- the byte value, or
0
if this compound does not contain a byte tag with the specified key, or has a tag with a different type - Since:
- 4.0.0
-
getByte
Gets a byte.- Parameters:
key
- the keydefaultValue
- the default value- Returns:
- the byte value, or
defaultValue
if this compound does not contain a byte tag with the specified key, or has a tag with a different type - Since:
- 4.0.0
-
getShort
Gets a short.- Parameters:
key
- the key- Returns:
- the short value, or
0
if this compound does not contain a short tag with the specified key, or has a tag with a different type - Since:
- 4.0.0
-
getShort
Gets a short.- Parameters:
key
- the keydefaultValue
- the default value- Returns:
- the short value, or
defaultValue
if this compound does not contain a short tag with the specified key, or has a tag with a different type - Since:
- 4.0.0
-
getInt
Gets an int.- Parameters:
key
- the key- Returns:
- the int value, or
0
if this compound does not contain an int tag with the specified key, or has a tag with a different type - Since:
- 4.0.0
-
getInt
Gets an int.- Parameters:
key
- the keydefaultValue
- the default value- Returns:
- the int value, or
defaultValue
if this compound does not contain an int tag with the specified key, or has a tag with a different type - Since:
- 4.0.0
-
getLong
Gets a long.- Parameters:
key
- the key- Returns:
- the long value, or
0
if this compound does not contain a long tag with the specified key, or has a tag with a different type - Since:
- 4.0.0
-
getLong
Gets a long.- Parameters:
key
- the keydefaultValue
- the default value- Returns:
- the long value, or
defaultValue
if this compound does not contain a long tag with the specified key, or has a tag with a different type - Since:
- 4.0.0
-
getFloat
Gets a float.- Parameters:
key
- the key- Returns:
- the float value, or
0
if this compound does not contain a float tag with the specified key, or has a tag with a different type - Since:
- 4.0.0
-
getFloat
Gets a float.- Parameters:
key
- the keydefaultValue
- the default value- Returns:
- the float value, or
defaultValue
if this compound does not contain a float tag with the specified key, or has a tag with a different type - Since:
- 4.0.0
-
getDouble
Gets a double.- Parameters:
key
- the key- Returns:
- the double value, or
0
if this compound does not contain a double tag with the specified key, or has a tag with a different type - Since:
- 4.0.0
-
getDouble
Gets a double.- Parameters:
key
- the keydefaultValue
- the default value- Returns:
- the double value, or
defaultValue
if this compound does not contain a double tag with the specified key, or has a tag with a different type - Since:
- 4.0.0
-
getByteArray
Gets an array of bytes.- Parameters:
key
- the key- Returns:
- the array of bytes, or a zero-length array if this compound does not contain a byte array tag with the specified key, or has a tag with a different type
- Since:
- 4.0.0
-
getByteArray
Gets an array of bytes.- Parameters:
key
- the keydefaultValue
- the default value- Returns:
- the array of bytes, or
defaultValue
- Since:
- 4.0.0
-
getString
Gets a string.- Parameters:
key
- the key- Returns:
- the string value, or
""
if this compound does not contain a string tag with the specified key, or has a tag with a different type - Since:
- 4.0.0
-
getString
Gets a string.- Parameters:
key
- the keydefaultValue
- the default value- Returns:
- the string value, or
defaultValue
if this compound does not contain a string tag with the specified key, or has a tag with a different type - Since:
- 4.0.0
-
getList
Gets a list.- Parameters:
key
- the key- Returns:
- the list, or a new list if this compound does not contain a list tag with the specified key, or has a tag with a different type
- Since:
- 4.0.0
-
getList
Gets a list.- Parameters:
key
- the keydefaultValue
- the default value- Returns:
- the list, or
defaultValue
if this compound does not contain a list tag with the specified key, or has a tag with a different type - Since:
- 4.0.0
-
getList
default @NonNull ListBinaryTag getList(@NonNull String key, @NonNull BinaryTagType<? extends BinaryTag> expectedType)Gets a list, ensuring that the type is the same astype
.- Parameters:
key
- the keyexpectedType
- the expected list type- Returns:
- the list, or a new list if this compound does not contain a list tag
with the specified key, has a tag with a different type, or the
list type
does not matchexpectedType
- Since:
- 4.0.0
-
getList
@NonNull ListBinaryTag getList(@NonNull String key, @NonNull BinaryTagType<? extends BinaryTag> expectedType, @NonNull ListBinaryTag defaultValue)Gets a list, ensuring that the type is the same astype
.- Parameters:
key
- the keyexpectedType
- the expected list typedefaultValue
- the default value- Returns:
- the list, or
defaultValue
if this compound does not contain a list tag with the specified key, has a tag with a different type, or thelist type
does not matchexpectedType
- Since:
- 4.0.0
-
getCompound
Gets a compound.- Parameters:
key
- the key- Returns:
- the compound, or a new compound if this compound does not contain a compound tag with the specified key, or has a tag with a different type
- Since:
- 4.0.0
-
getCompound
@NonNull CompoundBinaryTag getCompound(@NonNull String key, @NonNull CompoundBinaryTag defaultValue)Gets a compound.- Parameters:
key
- the keydefaultValue
- the default value- Returns:
- the compound, or
defaultValue
if this compound does not contain a compound tag with the specified key, or has a tag with a different type - Since:
- 4.0.0
-
getIntArray
Gets an array of ints.- Parameters:
key
- the key- Returns:
- the array of ints, or a zero-length array if this compound does not contain a int array tag with the specified key, or has a tag with a different type
- Since:
- 4.0.0
-
getIntArray
Gets an array of ints.- Parameters:
key
- the keydefaultValue
- the default value- Returns:
- the array of ints, or
defaultValue
- Since:
- 4.0.0
-
getLongArray
Gets an array of longs.- Parameters:
key
- the key- Returns:
- the array of longs, or a zero-length array if this compound does not contain a long array tag with the specified key, or has a tag with a different type
- Since:
- 4.0.0
-
getLongArray
Gets an array of longs.- Parameters:
key
- the keydefaultValue
- the default value- Returns:
- the array of longs, or
defaultValue
- Since:
- 4.0.0
-