Ion Java 1.11.10 · com.amazon.ion.impl.lite.ValueFactoryLite

Modifier and Type	Field and Description
private ContainerlessContext	_context
protected final _Private_LocalSymbolTableFactory	_lstFactory

Access	Constructor and Description
pack-priv	ValueFactoryLite()

Method Summary

Modifier and Type	Method and Description
public _Private_LocalSymbolTableFactory	getLstFactory() Implements com.amazon.ion.impl._Private_ValueFactory.getLstFactory. Gets the `LocalSymbolTableAsStruct.Factory` associated with this `ValueFactory`.
public IonBlobLite	newBlob(byte[] the data for the new blob, to be copied from the given array into the new instance. May be `null` to create a `null.blob` value. value) Implements com.amazon.ion.ValueFactory.newBlob. Constructs a new Ion `blob` instance, copying bytes from an array.
public IonBlobLite	newBlob(byte[] the data for the new blob, to be copied from the given array into the new instance. May be `null` to create a `null.blob` value. value, int the offset within the array of the first byte to copy; must be non-negative and no larger than `bytes.length`. offset, int the number of bytes to be copied from the given array; must be non-negative and no larger than `bytes.length - offset`. length) Implements com.amazon.ion.ValueFactory.newBlob. Constructs a new Ion `blob`, copying bytes from part of an array.
public IonBoolLite	newBool(boolean the new `bool`'s value. value) Implements com.amazon.ion.ValueFactory.newBool. Constructs a new `bool` instance with the given value.
public IonBoolLite	newBool(Boolean the new `bool`'s value. may be `null` to make `null.bool`. value) Implements com.amazon.ion.ValueFactory.newBool. Constructs a new `bool` instance with the given value.
public IonClobLite	newClob(byte[] the data for the new clob, to be copied from the given array into the new instance. May be `null` to create a `null.clob` value. value) Implements com.amazon.ion.ValueFactory.newClob. Constructs a new Ion `clob` instance from a byte array.
public IonClobLite	newClob(byte[] the data for the new blob, to be copied from the given array into the new instance. May be `null` to create a `null.clob` value. value, int the offset within the array of the first byte to copy; must be non-negative an no larger than `bytes.length`. offset, int the number of bytes to be copied from the given array; must be non-negative an no larger than `bytes.length - offset`. length) Implements com.amazon.ion.ValueFactory.newClob. Constructs a new Ion `clob`, copying bytes from part of an array.
public IonDecimalLite	newDecimal(long value) Implements com.amazon.ion.ValueFactory.newDecimal. Constructs a new Ion `decimal` instance from a Java `long`.
public IonDecimalLite	newDecimal(double value) Implements com.amazon.ion.ValueFactory.newDecimal. Constructs a new Ion `decimal` instance from a Java `double`.
public IonDecimalLite	newDecimal(BigInteger value) Implements com.amazon.ion.ValueFactory.newDecimal. Constructs a new Ion `decimal` instance from a Java `BigInteger`.
public IonDecimalLite	newDecimal(BigDecimal value) Implements com.amazon.ion.ValueFactory.newDecimal. Constructs a new Ion `decimal` instance from a Java `BigDecimal`.
public IonListLite	newEmptyList() Implements com.amazon.ion.ValueFactory.newEmptyList. Constructs a new empty (not null) `list` instance.
public IonSexpLite	newEmptySexp() Implements com.amazon.ion.ValueFactory.newEmptySexp. Constructs a new empty (not null) `sexp` instance.
public IonStructLite	newEmptyStruct() Implements com.amazon.ion.ValueFactory.newEmptyStruct. Constructs a new empty (not null) `struct` instance.
public IonFloatLite	newFloat(long value) Implements com.amazon.ion.ValueFactory.newFloat. Constructs a new Ion `float` instance from a Java `long`.
public IonFloatLite	newFloat(double value) Implements com.amazon.ion.ValueFactory.newFloat. Constructs a new Ion `float` instance from a Java `double`.
public IonIntLite	newInt(int the new int's value. value) Implements com.amazon.ion.ValueFactory.newInt. Constructs a new `int` instance with the given value.
public IonIntLite	newInt(long the new int's value. value) Implements com.amazon.ion.ValueFactory.newInt. Constructs a new `int` instance with the given value.
public IonIntLite	newInt(Number the new int's value; may be `null` to make `null.int`. value) Implements com.amazon.ion.ValueFactory.newInt. Constructs a new `int` instance with the given value.
private ArrayList<IonIntLite>	newInts(int[] elements)
private ArrayList<IonIntLite>	newInts(long[] elements)
public IonListLite	newList(Collection<? extends IonValue> the initial set of children. If `null`, then the new instance will have `IonValue#isNullValue() == true`. values) Implements com.amazon.ion.ValueFactory.newList. Constructs a new `list` with given children.
public IonListLite	newList(IonSequence the initial child of the new list. child) Implements com.amazon.ion.ValueFactory.newList. Constructs a new `list` with the given child.
public IonListLite	newList(IonValue... the initial sequence of children. If `null`, then the new instance will have `IonValue#isNullValue() == true`. values) Implements com.amazon.ion.ValueFactory.newList. Constructs a new `list` with the given children.
public IonListLite	newList(int[] the initial set of child values. If `null`, then the new instance will have `IonValue#isNullValue() == true`. Otherwise, the resulting sequence will contain new `IonInt`s with the given values. values) Implements com.amazon.ion.ValueFactory.newList. Constructs a new `list` with given `int` children.
public IonListLite	newList(long[] the initial set of child values. If `null`, then the new instance will have `IonValue#isNullValue() == true`. Otherwise, the resulting sequence will contain new `IonInt`s with the given values. values) Implements com.amazon.ion.ValueFactory.newList. Constructs a new `list` with given `long` child elements.
public IonNullLite	newNull() Implements com.amazon.ion.ValueFactory.newNull. Constructs a new `null.null` instance.
public IonValueLite	newNull(IonType must not be Java null, but it may be `IonType#NULL`. type) Implements com.amazon.ion.ValueFactory.newNull. Constructs a new Ion null value with the given type.
public IonBlobLite	newNullBlob() Implements com.amazon.ion.ValueFactory.newNullBlob. Constructs a new `null.blob` instance.
public IonBoolLite	newNullBool() Implements com.amazon.ion.ValueFactory.newNullBool. Constructs a new `null.bool` instance.
public IonClobLite	newNullClob() Implements com.amazon.ion.ValueFactory.newNullClob. Constructs a new `null.clob` instance.
public IonDecimalLite	newNullDecimal() Implements com.amazon.ion.ValueFactory.newNullDecimal. Constructs a new `null.decimal` instance.
public IonFloatLite	newNullFloat() Implements com.amazon.ion.ValueFactory.newNullFloat. Constructs a new `null.float` instance.
public IonIntLite	newNullInt() Implements com.amazon.ion.ValueFactory.newNullInt. Constructs a new `null.int` instance.
public IonListLite	newNullList() Implements com.amazon.ion.ValueFactory.newNullList. Constructs a new `null.list` instance.
public IonSexpLite	newNullSexp() Implements com.amazon.ion.ValueFactory.newNullSexp. Constructs a new `null.sexp` instance.
public IonStringLite	newNullString() Implements com.amazon.ion.ValueFactory.newNullString. Constructs a new `null.string` instance.
public IonStructLite	newNullStruct() Implements com.amazon.ion.ValueFactory.newNullStruct. Constructs a new `null.struct` instance.
public IonSymbolLite	newNullSymbol() Implements com.amazon.ion.ValueFactory.newNullSymbol. Constructs a new `null.symbol` instance.
public IonTimestampLite	newNullTimestamp() Implements com.amazon.ion.ValueFactory.newNullTimestamp. Constructs a new `null.timestamp` instance.
public IonSexpLite	newSexp(Collection<? extends IonValue> the initial set of children. If `null`, then the new instance will have `IonValue#isNullValue() == true`. values) Implements com.amazon.ion.ValueFactory.newSexp. Constructs a new `sexp` with given child elements.
public IonSexpLite	newSexp(IonSequence the initial child of the new sexp. child) Implements com.amazon.ion.ValueFactory.newSexp. Constructs a new `sexp` with the given child.
public IonSexp	newSexp(IonValue... the initial set of children. If `null`, then the new instance will have `IonValue#isNullValue() == true`. values) Implements com.amazon.ion.ValueFactory.newSexp. Constructs a new `sexp` with given child elements.
public IonSexpLite	newSexp(int[] the initial set of child values. If `null`, then the new instance will have `IonValue#isNullValue() == true`. Otherwise, the resulting sequence will contain new `IonInt`s with the given values. values) Implements com.amazon.ion.ValueFactory.newSexp. Constructs a new `sexp` with given `int` child values.
public IonSexpLite	newSexp(long[] the initial set of child values. If `null`, then the new instance will have `IonValue#isNullValue() == true`. Otherwise, the resulting sequence will contain new `IonInt`s with the given values. values) Implements com.amazon.ion.ValueFactory.newSexp. Constructs a new `sexp` with given `long` child elements.
public IonStringLite	newString(String the text of the new string; may be `null` to make `null.string`. value) Implements com.amazon.ion.ValueFactory.newString. Constructs a new Ion string with the given value.
public IonSymbolLite	newSymbol(String the text of the symbol; may be `null` to make `null.symbol`. value) Implements com.amazon.ion.ValueFactory.newSymbol. Constructs a new Ion symbol with the given value.
public IonSymbolLite	newSymbol(SymbolToken the text and/or SID of the symbol; may be `null` to make `null.symbol`. value) Implements com.amazon.ion.ValueFactory.newSymbol. Constructs a new Ion symbol with the given symbol token.
public IonTimestampLite	newTimestamp(Timestamp may be `null` to make `null.timestamp`. value) Implements com.amazon.ion.ValueFactory.newTimestamp. Constructs a new `timestamp` instance with the given value.
protected void	set_system(IonSystemLite system)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

_context	back to summary
private ContainerlessContext _context

_lstFactory	back to summary
protected final _Private_LocalSymbolTableFactory _lstFactory

ValueFactoryLite	back to summary
pack-priv ValueFactoryLite()

Method Detail

getLstFactory back to summary

getLstFactory	back to summary
public _Private_LocalSymbolTableFactory getLstFactory() Implements com.amazon.ion.impl._Private_ValueFactory.getLstFactory. Doc from com.amazon.ion.impl._Private_ValueFactory.getLstFactory. Gets the `LocalSymbolTableAsStruct.Factory` associated with this `ValueFactory`. This is used to construct local symbol tables backed by `IonStruct`s. Note that this should not be used in new code; use `LocalSymbolTable` instead. Returns:_Private_LocalSymbolTableFactory a LocalSymbolTableAsStruct.Factory; never null.

public _Private_LocalSymbolTableFactory getLstFactory()

Implements com.amazon.ion.impl._Private_ValueFactory.getLstFactory.

Doc from com.amazon.ion.impl._Private_ValueFactory.getLstFactory.

Gets the LocalSymbolTableAsStruct.Factory associated with this ValueFactory. This is used to construct local symbol tables backed by IonStructs. Note that this should not be used in new code; use LocalSymbolTable instead.

Returns:_Private_LocalSymbolTableFactory: a LocalSymbolTableAsStruct.Factory; never null.

newBlob back to summary

newBlob	back to summary
public IonBlobLite newBlob(byte[] value) Implements com.amazon.ion.ValueFactory.newBlob. Doc from com.amazon.ion.ValueFactory.newBlob. Constructs a new Ion `blob` instance, copying bytes from an array. Parameters value:byte[] the data for the new blob, to be copied from the given array into the new instance. May be `null` to create a `null.blob` value.

public IonBlobLite newBlob(byte[] value)

Implements com.amazon.ion.ValueFactory.newBlob.

Doc from com.amazon.ion.ValueFactory.newBlob.

Constructs a new Ion blob instance, copying bytes from an array.

Parameters

value:byte[]: the data for the new blob, to be copied from the given array into the new instance. May be null to create a null.blob value.

newBlob back to summary

newBlob	back to summary
public IonBlobLite newBlob(byte[] value, int offset, int length) Implements com.amazon.ion.ValueFactory.newBlob. Doc from com.amazon.ion.ValueFactory.newBlob. Constructs a new Ion `blob`, copying bytes from part of an array. This method copies `length` bytes from the given array into the new value, starting at the given offset in the array. Parameters value:byte[] the data for the new blob, to be copied from the given array into the new instance. May be `null` to create a `null.blob` value. offset:int the offset within the array of the first byte to copy; must be non-negative and no larger than `bytes.length`. length:int the number of bytes to be copied from the given array; must be non-negative and no larger than `bytes.length - offset`.

public IonBlobLite newBlob(byte[] value, int offset, int length)

Implements com.amazon.ion.ValueFactory.newBlob.

Doc from com.amazon.ion.ValueFactory.newBlob.

Constructs a new Ion blob, copying bytes from part of an array.

This method copies length bytes from the given array into the new value, starting at the given offset in the array.

Parameters

value:byte[]: the data for the new blob, to be copied from the given array into the new instance. May be null to create a null.blob value.
offset:int: the offset within the array of the first byte to copy; must be non-negative and no larger than bytes.length.
length:int: the number of bytes to be copied from the given array; must be non-negative and no larger than bytes.length - offset.

newBool back to summary

newBool	back to summary
public IonBoolLite newBool(boolean value) Implements com.amazon.ion.ValueFactory.newBool. Doc from com.amazon.ion.ValueFactory.newBool. Constructs a new `bool` instance with the given value. Parameters value:boolean the new `bool`'s value. Returns:IonBoolLite a bool with `IonBool#booleanValue() == value`.

public IonBoolLite newBool(boolean value)

Implements com.amazon.ion.ValueFactory.newBool.

Doc from com.amazon.ion.ValueFactory.newBool.

Constructs a new bool instance with the given value.

Parameters

value:boolean: the new bool's value.

Returns:IonBoolLite

a bool with IonBool#booleanValue() == value.

newBool back to summary

newBool	back to summary
public IonBoolLite newBool(Boolean value) Implements com.amazon.ion.ValueFactory.newBool. Doc from com.amazon.ion.ValueFactory.newBool. Constructs a new `bool` instance with the given value. Parameters value:Boolean the new `bool`'s value. may be `null` to make `null.bool`.

public IonBoolLite newBool(Boolean value)

Implements com.amazon.ion.ValueFactory.newBool.

Doc from com.amazon.ion.ValueFactory.newBool.

Constructs a new bool instance with the given value.

Parameters

value:Boolean: the new bool's value. may be null to make null.bool.

newClob back to summary

newClob	back to summary
public IonClobLite newClob(byte[] value) Implements com.amazon.ion.ValueFactory.newClob. Doc from com.amazon.ion.ValueFactory.newClob. Constructs a new Ion `clob` instance from a byte array. Parameters value:byte[] the data for the new clob, to be copied from the given array into the new instance. May be `null` to create a `null.clob` value.

public IonClobLite newClob(byte[] value)

Implements com.amazon.ion.ValueFactory.newClob.

Doc from com.amazon.ion.ValueFactory.newClob.

Constructs a new Ion clob instance from a byte array.

Parameters

value:byte[]: the data for the new clob, to be copied from the given array into the new instance. May be null to create a null.clob value.

newClob back to summary

newClob	back to summary
public IonClobLite newClob(byte[] value, int offset, int length) Implements com.amazon.ion.ValueFactory.newClob. Doc from com.amazon.ion.ValueFactory.newClob. Constructs a new Ion `clob`, copying bytes from part of an array. This method copies `length` bytes from the given array into the new value, starting at the given offset in the array. Parameters value:byte[] the data for the new blob, to be copied from the given array into the new instance. May be `null` to create a `null.clob` value. offset:int the offset within the array of the first byte to copy; must be non-negative an no larger than `bytes.length`. length:int the number of bytes to be copied from the given array; must be non-negative an no larger than `bytes.length - offset`.

public IonClobLite newClob(byte[] value, int offset, int length)

Implements com.amazon.ion.ValueFactory.newClob.

Doc from com.amazon.ion.ValueFactory.newClob.

Constructs a new Ion clob, copying bytes from part of an array.

This method copies length bytes from the given array into the new value, starting at the given offset in the array.

Parameters

value:byte[]: the data for the new blob, to be copied from the given array into the new instance. May be null to create a null.clob value.
offset:int: the offset within the array of the first byte to copy; must be non-negative an no larger than bytes.length.
length:int: the number of bytes to be copied from the given array; must be non-negative an no larger than bytes.length - offset.

newDecimal back to summary

newDecimal	back to summary
public IonDecimalLite newDecimal(long value) Implements com.amazon.ion.ValueFactory.newDecimal. Doc from com.amazon.ion.ValueFactory.newDecimal. Constructs a new Ion `decimal` instance from a Java `long`.

public IonDecimalLite newDecimal(long value)

Implements com.amazon.ion.ValueFactory.newDecimal.

Doc from com.amazon.ion.ValueFactory.newDecimal.

Constructs a new Ion decimal instance from a Java long.

newDecimal back to summary

newDecimal	back to summary
public IonDecimalLite newDecimal(double value) Implements com.amazon.ion.ValueFactory.newDecimal. Doc from com.amazon.ion.ValueFactory.newDecimal. Constructs a new Ion `decimal` instance from a Java `double`. Note that this does not generate the exact decimal representation of the `double`'s binary floating-point value as via `BigDecimal#BigDecimal(double)`, but instead uses the more predictable behavior of matching the double's string representation as via `BigDecimal#valueOf(double)`.

public IonDecimalLite newDecimal(double value)

Implements com.amazon.ion.ValueFactory.newDecimal.

Doc from com.amazon.ion.ValueFactory.newDecimal.

Constructs a new Ion decimal instance from a Java double.

Note that this does not generate the exact decimal representation of the double's binary floating-point value as via BigDecimal#BigDecimal(double), but instead uses the more predictable behavior of matching the double's string representation as via BigDecimal#valueOf(double).

newDecimal back to summary

newDecimal	back to summary
public IonDecimalLite newDecimal(BigInteger value) Implements com.amazon.ion.ValueFactory.newDecimal. Doc from com.amazon.ion.ValueFactory.newDecimal. Constructs a new Ion `decimal` instance from a Java `BigInteger`.

public IonDecimalLite newDecimal(BigInteger value)

Implements com.amazon.ion.ValueFactory.newDecimal.

Doc from com.amazon.ion.ValueFactory.newDecimal.

Constructs a new Ion decimal instance from a Java BigInteger.

newDecimal back to summary

newDecimal	back to summary
public IonDecimalLite newDecimal(BigDecimal value) Implements com.amazon.ion.ValueFactory.newDecimal. Doc from com.amazon.ion.ValueFactory.newDecimal. Constructs a new Ion `decimal` instance from a Java `BigDecimal`. To create negative zero values, pass a `Decimal`.

public IonDecimalLite newDecimal(BigDecimal value)

Implements com.amazon.ion.ValueFactory.newDecimal.

Doc from com.amazon.ion.ValueFactory.newDecimal.

Constructs a new Ion decimal instance from a Java BigDecimal. To create negative zero values, pass a Decimal.

newEmptyList back to summary

newEmptyList	back to summary
public IonListLite newEmptyList() Implements com.amazon.ion.ValueFactory.newEmptyList. Doc from com.amazon.ion.ValueFactory.newEmptyList. Constructs a new empty (not null) `list` instance.

public IonListLite newEmptyList()

Implements com.amazon.ion.ValueFactory.newEmptyList.

Doc from com.amazon.ion.ValueFactory.newEmptyList.

Constructs a new empty (not null) list instance.

newEmptySexp back to summary

newEmptySexp	back to summary
public IonSexpLite newEmptySexp() Implements com.amazon.ion.ValueFactory.newEmptySexp. Doc from com.amazon.ion.ValueFactory.newEmptySexp. Constructs a new empty (not null) `sexp` instance.

public IonSexpLite newEmptySexp()

Implements com.amazon.ion.ValueFactory.newEmptySexp.

Doc from com.amazon.ion.ValueFactory.newEmptySexp.

Constructs a new empty (not null) sexp instance.

newEmptyStruct back to summary

newEmptyStruct	back to summary
public IonStructLite newEmptyStruct() Implements com.amazon.ion.ValueFactory.newEmptyStruct. Doc from com.amazon.ion.ValueFactory.newEmptyStruct. Constructs a new empty (not null) `struct` instance.

public IonStructLite newEmptyStruct()

Implements com.amazon.ion.ValueFactory.newEmptyStruct.

Doc from com.amazon.ion.ValueFactory.newEmptyStruct.

Constructs a new empty (not null) struct instance.

newFloat back to summary

newFloat	back to summary
public IonFloatLite newFloat(long value) Implements com.amazon.ion.ValueFactory.newFloat. Doc from com.amazon.ion.ValueFactory.newFloat. Constructs a new Ion `float` instance from a Java `long`.

public IonFloatLite newFloat(long value)

Implements com.amazon.ion.ValueFactory.newFloat.

Doc from com.amazon.ion.ValueFactory.newFloat.

Constructs a new Ion float instance from a Java long.

newFloat back to summary

newFloat	back to summary
public IonFloatLite newFloat(double value) Implements com.amazon.ion.ValueFactory.newFloat. Doc from com.amazon.ion.ValueFactory.newFloat. Constructs a new Ion `float` instance from a Java `double`.

public IonFloatLite newFloat(double value)

Implements com.amazon.ion.ValueFactory.newFloat.

Doc from com.amazon.ion.ValueFactory.newFloat.

Constructs a new Ion float instance from a Java double.

newInt back to summary

newInt	back to summary
public IonIntLite newInt(int value) Implements com.amazon.ion.ValueFactory.newInt. Doc from com.amazon.ion.ValueFactory.newInt. Constructs a new `int` instance with the given value. Parameters value:int the new int's value.

public IonIntLite newInt(int value)

Implements com.amazon.ion.ValueFactory.newInt.

Doc from com.amazon.ion.ValueFactory.newInt.

Constructs a new int instance with the given value.

Parameters

value:int: the new int's value.

newInt back to summary

newInt	back to summary
public IonIntLite newInt(long value) Implements com.amazon.ion.ValueFactory.newInt. Doc from com.amazon.ion.ValueFactory.newInt. Constructs a new `int` instance with the given value. Parameters value:long the new int's value.

public IonIntLite newInt(long value)

Implements com.amazon.ion.ValueFactory.newInt.

Doc from com.amazon.ion.ValueFactory.newInt.

Constructs a new int instance with the given value.

Parameters

value:long: the new int's value.

newInt back to summary

newInt	back to summary
public IonIntLite newInt(Number value) Implements com.amazon.ion.ValueFactory.newInt. Doc from com.amazon.ion.ValueFactory.newInt. Constructs a new `int` instance with the given value. The integer portion of the number is used, any fractional portion is ignored. Parameters value:Number the new int's value; may be `null` to make `null.int`.

public IonIntLite newInt(Number value)

Implements com.amazon.ion.ValueFactory.newInt.

Doc from com.amazon.ion.ValueFactory.newInt.

Constructs a new int instance with the given value. The integer portion of the number is used, any fractional portion is ignored.

Parameters

value:Number: the new int's value; may be null to make null.int.

newInts	back to summary
private ArrayList<IonIntLite> newInts(int[] elements)

newInts	back to summary
private ArrayList<IonIntLite> newInts(long[] elements)

newList back to summary

newList	back to summary
public IonListLite newList(Collection<? extends IonValue> values) throws ContainedValueException, NullPointerException Implements com.amazon.ion.ValueFactory.newList. Doc from com.amazon.ion.ValueFactory.newList. Constructs a new `list` with given children. Parameters values:Collection<? extends IonValue> the initial set of children. If `null`, then the new instance will have `IonValue#isNullValue() == true`. Exceptions ContainedValueException: if any value in `values` has `IonValue#getContainer() != null`. NullPointerException: if any value in `values` is null.

public IonListLite newList(Collection<? extends IonValue> values) throws ContainedValueException, NullPointerException

Implements com.amazon.ion.ValueFactory.newList.

Doc from com.amazon.ion.ValueFactory.newList.

Constructs a new list with given children.

Parameters

values:Collection<? extends IonValue>: the initial set of children. If null, then the new instance will have IonValue#isNullValue() == true.

Exceptions

ContainedValueException:: if any value in values has IonValue#getContainer() != null.
NullPointerException:: if any value in values is null.

newList back to summary

newList	back to summary
public IonListLite newList(IonSequence child) throws ContainedValueException, NullPointerException Implements com.amazon.ion.ValueFactory.newList. Doc from com.amazon.ion.ValueFactory.newList. Constructs a new `list` with the given child. This method is temporary until `newList(Collection)` is removed. It's sole purpose is to avoid the doomed attempt to add all of the parameter's children to the new list; that will always throw `ContainedValueException`. Parameters child:IonSequence the initial child of the new list. Exceptions ContainedValueException: if `child` has `IonValue#getContainer() != null`. NullPointerException: if `child` is null.

public IonListLite newList(IonSequence child) throws ContainedValueException, NullPointerException

Implements com.amazon.ion.ValueFactory.newList.

Doc from com.amazon.ion.ValueFactory.newList.

Constructs a new list with the given child.

This method is temporary until newList(Collection) is removed. It's sole purpose is to avoid the doomed attempt to add all of the parameter's children to the new list; that will always throw ContainedValueException.

Parameters

child:IonSequence: the initial child of the new list.

Exceptions

ContainedValueException:: if child has IonValue#getContainer() != null.
NullPointerException:: if child is null.

newList back to summary

newList	back to summary
public IonListLite newList(IonValue... values) throws ContainedValueException, NullPointerException Implements com.amazon.ion.ValueFactory.newList. Doc from com.amazon.ion.ValueFactory.newList. Constructs a new `list` with the given children. Some edge cases are worth examples: factory.newList(); // returns [] factory.newList((IonValue[]) null); // returns null.list For clarity, applications should prefer `newEmptyList()` and `newNullList()` instead. Parameters values:IonValue[] the initial sequence of children. If `null`, then the new instance will have `IonValue#isNullValue() == true`. Exceptions ContainedValueException: if any child has `IonValue#getContainer() != null`. NullPointerException: if any child is null.

public IonListLite newList(IonValue... values) throws ContainedValueException, NullPointerException

Implements com.amazon.ion.ValueFactory.newList.

Doc from com.amazon.ion.ValueFactory.newList.

Constructs a new list with the given children.

Some edge cases are worth examples:

    factory.newList();                     // returns []
    factory.newList((IonValue[]) null);    // returns null.list

For clarity, applications should prefer newEmptyList() and newNullList() instead.

Parameters

values:IonValue[]: the initial sequence of children. If null, then the new instance will have IonValue#isNullValue() == true.

Exceptions

ContainedValueException:: if any child has IonValue#getContainer() != null.
NullPointerException:: if any child is null.

newList back to summary

newList	back to summary
public IonListLite newList(int[] values) Implements com.amazon.ion.ValueFactory.newList. Doc from com.amazon.ion.ValueFactory.newList. Constructs a new `list` with given `int` children. Parameters values:int[] the initial set of child values. If `null`, then the new instance will have `IonValue#isNullValue() == true`. Otherwise, the resulting sequence will contain new `IonInt`s with the given values. Returns:IonListLite a new list where each element is an `IonInt`.

public IonListLite newList(int[] values)

Implements com.amazon.ion.ValueFactory.newList.

Doc from com.amazon.ion.ValueFactory.newList.

Constructs a new list with given int children.

Parameters

values:int[]: the initial set of child values. If null, then the new instance will have IonValue#isNullValue() == true. Otherwise, the resulting sequence will contain new IonInts with the given values.

Returns:IonListLite

a new list where each element is an IonInt.

newList back to summary

newList	back to summary
public IonListLite newList(long[] values) Implements com.amazon.ion.ValueFactory.newList. Doc from com.amazon.ion.ValueFactory.newList. Constructs a new `list` with given `long` child elements. Parameters values:long[] the initial set of child values. If `null`, then the new instance will have `IonValue#isNullValue() == true`. Otherwise, the resulting sequence will contain new `IonInt`s with the given values. Returns:IonListLite a new list where each element is an `IonInt`.

public IonListLite newList(long[] values)

Implements com.amazon.ion.ValueFactory.newList.

Doc from com.amazon.ion.ValueFactory.newList.

Constructs a new list with given long child elements.

Parameters

values:long[]: the initial set of child values. If null, then the new instance will have IonValue#isNullValue() == true. Otherwise, the resulting sequence will contain new IonInts with the given values.

Returns:IonListLite

a new list where each element is an IonInt.

newNull back to summary

newNull	back to summary
public IonNullLite newNull() Implements com.amazon.ion.ValueFactory.newNull. Doc from com.amazon.ion.ValueFactory.newNull. Constructs a new `null.null` instance.

public IonNullLite newNull()

Implements com.amazon.ion.ValueFactory.newNull.

Doc from com.amazon.ion.ValueFactory.newNull.

Constructs a new null.null instance.

newNull back to summary

newNull	back to summary
public IonValueLite newNull(IonType type) Implements com.amazon.ion.ValueFactory.newNull. Doc from com.amazon.ion.ValueFactory.newNull. Constructs a new Ion null value with the given type. Parameters type:IonType must not be Java null, but it may be `IonType#NULL`. Returns:IonValueLite a new value such that `IonValue#isNullValue()` is `true`.

public IonValueLite newNull(IonType type)

Implements com.amazon.ion.ValueFactory.newNull.

Doc from com.amazon.ion.ValueFactory.newNull.

Constructs a new Ion null value with the given type.

Parameters

type:IonType: must not be Java null, but it may be IonType#NULL.

Returns:IonValueLite

a new value such that IonValue#isNullValue() is true.

newNullBlob back to summary

newNullBlob	back to summary
public IonBlobLite newNullBlob() Implements com.amazon.ion.ValueFactory.newNullBlob. Doc from com.amazon.ion.ValueFactory.newNullBlob. Constructs a new `null.blob` instance.

public IonBlobLite newNullBlob()

Implements com.amazon.ion.ValueFactory.newNullBlob.

Doc from com.amazon.ion.ValueFactory.newNullBlob.

Constructs a new null.blob instance.

newNullBool back to summary

newNullBool	back to summary
public IonBoolLite newNullBool() Implements com.amazon.ion.ValueFactory.newNullBool. Doc from com.amazon.ion.ValueFactory.newNullBool. Constructs a new `null.bool` instance.

public IonBoolLite newNullBool()

Implements com.amazon.ion.ValueFactory.newNullBool.

Doc from com.amazon.ion.ValueFactory.newNullBool.

Constructs a new null.bool instance.

newNullClob back to summary

newNullClob	back to summary
public IonClobLite newNullClob() Implements com.amazon.ion.ValueFactory.newNullClob. Doc from com.amazon.ion.ValueFactory.newNullClob. Constructs a new `null.clob` instance.

public IonClobLite newNullClob()

Implements com.amazon.ion.ValueFactory.newNullClob.

Doc from com.amazon.ion.ValueFactory.newNullClob.

Constructs a new null.clob instance.

newNullDecimal back to summary

newNullDecimal	back to summary
public IonDecimalLite newNullDecimal() Implements com.amazon.ion.ValueFactory.newNullDecimal. Doc from com.amazon.ion.ValueFactory.newNullDecimal. Constructs a new `null.decimal` instance.

public IonDecimalLite newNullDecimal()

Implements com.amazon.ion.ValueFactory.newNullDecimal.

Doc from com.amazon.ion.ValueFactory.newNullDecimal.

Constructs a new null.decimal instance.

newNullFloat back to summary

newNullFloat	back to summary
public IonFloatLite newNullFloat() Implements com.amazon.ion.ValueFactory.newNullFloat. Doc from com.amazon.ion.ValueFactory.newNullFloat. Constructs a new `null.float` instance.

public IonFloatLite newNullFloat()

Implements com.amazon.ion.ValueFactory.newNullFloat.

Doc from com.amazon.ion.ValueFactory.newNullFloat.

Constructs a new null.float instance.

newNullInt back to summary

newNullInt	back to summary
public IonIntLite newNullInt() Implements com.amazon.ion.ValueFactory.newNullInt. Doc from com.amazon.ion.ValueFactory.newNullInt. Constructs a new `null.int` instance.

public IonIntLite newNullInt()

Implements com.amazon.ion.ValueFactory.newNullInt.

Doc from com.amazon.ion.ValueFactory.newNullInt.

Constructs a new null.int instance.

newNullList back to summary

newNullList	back to summary
public IonListLite newNullList() Implements com.amazon.ion.ValueFactory.newNullList. Doc from com.amazon.ion.ValueFactory.newNullList. Constructs a new `null.list` instance.

public IonListLite newNullList()

Implements com.amazon.ion.ValueFactory.newNullList.

Doc from com.amazon.ion.ValueFactory.newNullList.

Constructs a new null.list instance.

newNullSexp back to summary

newNullSexp	back to summary
public IonSexpLite newNullSexp() Implements com.amazon.ion.ValueFactory.newNullSexp. Doc from com.amazon.ion.ValueFactory.newNullSexp. Constructs a new `null.sexp` instance.

public IonSexpLite newNullSexp()

Implements com.amazon.ion.ValueFactory.newNullSexp.

Doc from com.amazon.ion.ValueFactory.newNullSexp.

Constructs a new null.sexp instance.

newNullString back to summary

newNullString	back to summary
public IonStringLite newNullString() Implements com.amazon.ion.ValueFactory.newNullString. Doc from com.amazon.ion.ValueFactory.newNullString. Constructs a new `null.string` instance.

public IonStringLite newNullString()

Implements com.amazon.ion.ValueFactory.newNullString.

Doc from com.amazon.ion.ValueFactory.newNullString.

Constructs a new null.string instance.

newNullStruct back to summary

newNullStruct	back to summary
public IonStructLite newNullStruct() Implements com.amazon.ion.ValueFactory.newNullStruct. Doc from com.amazon.ion.ValueFactory.newNullStruct. Constructs a new `null.struct` instance.

public IonStructLite newNullStruct()

Implements com.amazon.ion.ValueFactory.newNullStruct.

Doc from com.amazon.ion.ValueFactory.newNullStruct.

Constructs a new null.struct instance.

newNullSymbol back to summary

newNullSymbol	back to summary
public IonSymbolLite newNullSymbol() Implements com.amazon.ion.ValueFactory.newNullSymbol. Doc from com.amazon.ion.ValueFactory.newNullSymbol. Constructs a new `null.symbol` instance.

public IonSymbolLite newNullSymbol()

Implements com.amazon.ion.ValueFactory.newNullSymbol.

Doc from com.amazon.ion.ValueFactory.newNullSymbol.

Constructs a new null.symbol instance.

newNullTimestamp back to summary

newNullTimestamp	back to summary
public IonTimestampLite newNullTimestamp() Implements com.amazon.ion.ValueFactory.newNullTimestamp. Doc from com.amazon.ion.ValueFactory.newNullTimestamp. Constructs a new `null.timestamp` instance.

public IonTimestampLite newNullTimestamp()

Implements com.amazon.ion.ValueFactory.newNullTimestamp.

Doc from com.amazon.ion.ValueFactory.newNullTimestamp.

Constructs a new null.timestamp instance.

newSexp back to summary

newSexp	back to summary
public IonSexpLite newSexp(Collection<? extends IonValue> values) throws ContainedValueException, NullPointerException Implements com.amazon.ion.ValueFactory.newSexp. Doc from com.amazon.ion.ValueFactory.newSexp. Constructs a new `sexp` with given child elements. Parameters values:Collection<? extends IonValue> the initial set of children. If `null`, then the new instance will have `IonValue#isNullValue() == true`. Exceptions ContainedValueException: if any value in `values` has `IonValue#getContainer() != null`. NullPointerException: if any value in `values` is null.

public IonSexpLite newSexp(Collection<? extends IonValue> values) throws ContainedValueException, NullPointerException

Implements com.amazon.ion.ValueFactory.newSexp.

Doc from com.amazon.ion.ValueFactory.newSexp.

Constructs a new sexp with given child elements.

Parameters

values:Collection<? extends IonValue>: the initial set of children. If null, then the new instance will have IonValue#isNullValue() == true.

Exceptions

ContainedValueException:: if any value in values has IonValue#getContainer() != null.
NullPointerException:: if any value in values is null.

newSexp back to summary

newSexp	back to summary
public IonSexpLite newSexp(IonSequence child) throws ContainedValueException, NullPointerException Implements com.amazon.ion.ValueFactory.newSexp. Doc from com.amazon.ion.ValueFactory.newSexp. Constructs a new `sexp` with the given child. This method is temporary until `newSexp(Collection)` is removed. It's sole purpose is to avoid the doomed attempt to add all of the parameter's children to the new sequence; that will always throw `ContainedValueException`. Parameters child:IonSequence the initial child of the new sexp. Exceptions ContainedValueException: if `child` has `IonValue#getContainer() != null`. NullPointerException: if `child` is null.

public IonSexpLite newSexp(IonSequence child) throws ContainedValueException, NullPointerException

Implements com.amazon.ion.ValueFactory.newSexp.

Doc from com.amazon.ion.ValueFactory.newSexp.

Constructs a new sexp with the given child.

This method is temporary until newSexp(Collection) is removed. It's sole purpose is to avoid the doomed attempt to add all of the parameter's children to the new sequence; that will always throw ContainedValueException.

Parameters

child:IonSequence: the initial child of the new sexp.

Exceptions

ContainedValueException:: if child has IonValue#getContainer() != null.
NullPointerException:: if child is null.

newSexp back to summary

newSexp	back to summary
public IonSexp newSexp(IonValue... values) throws ContainedValueException, NullPointerException Implements com.amazon.ion.ValueFactory.newSexp. Doc from com.amazon.ion.ValueFactory.newSexp. Constructs a new `sexp` with given child elements. Some edge cases are worth examples: factory.newSexp(); // returns () factory.newSexp((IonValue[]) null); // returns null.sexp For clarity, applications should prefer `newEmptySexp()` and `newNullSexp()` instead. Parameters values:IonValue[] the initial set of children. If `null`, then the new instance will have `IonValue#isNullValue() == true`. Exceptions ContainedValueException: if any child has `IonValue#getContainer() != null`. NullPointerException: if any child is null.

public IonSexp newSexp(IonValue... values) throws ContainedValueException, NullPointerException

Implements com.amazon.ion.ValueFactory.newSexp.

Doc from com.amazon.ion.ValueFactory.newSexp.

Constructs a new sexp with given child elements.

Some edge cases are worth examples:

    factory.newSexp();                     // returns ()
    factory.newSexp((IonValue[]) null);    // returns null.sexp

For clarity, applications should prefer newEmptySexp() and newNullSexp() instead.

Parameters

values:IonValue[]: the initial set of children. If null, then the new instance will have IonValue#isNullValue() == true.

Exceptions

ContainedValueException:: if any child has IonValue#getContainer() != null.
NullPointerException:: if any child is null.

newSexp back to summary

newSexp	back to summary
public IonSexpLite newSexp(int[] values) Implements com.amazon.ion.ValueFactory.newSexp. Doc from com.amazon.ion.ValueFactory.newSexp. Constructs a new `sexp` with given `int` child values. Parameters values:int[] the initial set of child values. If `null`, then the new instance will have `IonValue#isNullValue() == true`. Otherwise, the resulting sequence will contain new `IonInt`s with the given values. Returns:IonSexpLite a new sexp where each element is an `IonInt`.

public IonSexpLite newSexp(int[] values)

Implements com.amazon.ion.ValueFactory.newSexp.

Doc from com.amazon.ion.ValueFactory.newSexp.

Constructs a new sexp with given int child values.

Parameters

values:int[]: the initial set of child values. If null, then the new instance will have IonValue#isNullValue() == true. Otherwise, the resulting sequence will contain new IonInts with the given values.

Returns:IonSexpLite

a new sexp where each element is an IonInt.

newSexp back to summary

public IonSexpLite newSexp(long[] values)

Implements com.amazon.ion.ValueFactory.newSexp.

Doc from com.amazon.ion.ValueFactory.newSexp.

Constructs a new sexp with given long child elements.

Parameters

values:long[]: the initial set of child values. If null, then the new instance will have IonValue#isNullValue() == true. Otherwise, the resulting sequence will contain new IonInts with the given values.

Returns:IonSexpLite