software.amazon.ion

Interface IonSymbol

All Superinterfaces:

Cloneable, IonText, IonValue

public interface IonSymbol
extends IonText

An Ion symbol value.

WARNING: This interface should not be implemented or extended by code outside of this library.

Field Summary

Fields inherited from interface software.amazon.ion.IonValue

EMPTY_ARRAY

Method Summary

Modifier and Type	Method and Description
IonSymbol	clone() Creates a copy of this value and all of its children.
void	setValue(String value) Changes the value of this element.
String	stringValue() Gets the text content of this symbol.
SymbolToken	symbolValue() Returns this value as a symbol token (text + ID).

Methods inherited from interface software.amazon.ion.IonValue

accept, addTypeAnnotation, clearTypeAnnotations, equals, getContainer, getFieldName, getFieldNameSymbol, getSymbolTable, getSystem, getType, getTypeAnnotations, getTypeAnnotationSymbols, hashCode, hasTypeAnnotation, isNullValue, isReadOnly, makeReadOnly, removeFromContainer, removeTypeAnnotation, setTypeAnnotations, setTypeAnnotationSymbols, topLevelValue, toPrettyString, toString, toString, writeTo

Method Detail

stringValue

String stringValue()
            throws UnknownSymbolException

Gets the text content of this symbol.

Specified by:

stringValue in interface IonText

Returns:

the text of the symbol, or null if this is null.symbol.

Throws:

UnknownSymbolException - if this symbol has unknown text.

See Also:

symbolValue()

symbolValue

SymbolToken symbolValue()

Returns this value as a symbol token (text + ID).

Returns:

null if IonValue.isNullValue()

setValue

void setValue(String value)
       throws EmptySymbolException

Changes the value of this element.

Specified by:

setValue in interface IonText

Parameters:

value - the new value of this symbol; may be null to make this null.symbol.

Throws:

EmptySymbolException - if value is the empty string.

clone

IonSymbol clone()
         throws UnknownSymbolException

Description copied from interface: IonValue

Creates a copy of this value and all of its children. The cloned value may use the same shared symbol tables, but it will have an independent local symbol table if necessary. The cloned value will be modifiable regardless of whether this instance IonValue.isReadOnly().

The cloned value will be created in the context of the same ValueFactory as this instance; if you want a copy using a different factory, then use ValueFactory.clone(IonValue) instead.

Specified by:

clone in interface IonText

Specified by:

clone in interface IonValue

Throws:

UnknownSymbolException - if any part of this value has unknown text but known Sid for its field name, annotation or symbol.