This differs from utf8(String) by using our custem encoder. Not sure which is better. TODO benchmark the two approaches

Creates a mutable copy of this local symbol table. The cloned table will be created in the context of the same ValueFactory.

Note that the resulting symbol table holds a distinct, deep copy of the given table, adding symbols on either instances will not modify the other.

Returns:SymbolTable

a new mutable SymbolTable instance; not null

Exceptions

SubstituteSymbolTableException:

if any imported table by the given local symbol table is a substituted table (whereby no exact match was found in its catalog)

IllegalArgumentException:

if the given table is not a local symbol table

Replacement for Java6 Arrays#copyOf(byte[], int).

Decodes a byte sequence into a string, given a Charset.

This method is preferred to Charset#decode(ByteBuffer) and String#String(byte[], Charset) (etc.) since those methods will replace or ignore bad input, and here we throw an exception.

Parameters

bytes:byte[]

the data to decode.

Returns:String

the decoded string, not null.

Exceptions

IonException:

if there's a CharacterCodingException.

Annotations

@SuppressWarnings:unchecked

Encodes a String into bytes of a given encoding.

This method is preferred to Charset#encode(String) and String#getBytes(String) (etc.) since those methods will replace or ignore bad input, and here we throw an exception.

Parameters

s:String

the string to encode.

Returns:byte[]

the encoded string, not null.

Exceptions

IonException:

if there's a CharacterCodingException.

Returns the symbol ID matching a system symbol text of a local or shared symtab field.

Returns a minimal symtab that, either system or local depending on the given values, that supports representation as an IonStruct. If the imports are empty, the default system symtab is returned.

Parameters

lstFactory:_Private_LocalSymbolTableFactory

the factory to use to build the local symbol table, never null

defaultSystemSymtab:SymbolTable

the default system symtab, which will be used if the first import in imports isn't a system symtab, never null

imports:SymbolTable[]

the set of shared symbol tables to import; may be null or empty. The first (and only the first) may be a system table, in which case the defaultSystemSymtab is ignored.

Determines whether the passed-in data type is a scalar and not a symbol.

Is the table null, system, or local without imported symbols?

Create a value iterator from a reader. Primarily a trampoline for access permission.

Parameters

syms:SymbolToken[]

may be mutated, replacing entries with localized updates!

Parameters

syms:SymbolToken[]

may be mutated, replacing entries with localized updates!

Trampoline to LocalSymbolTableAsStruct.Factory#Factory(ValueFactory)

Parameters

imageFactory:ValueFactory

the ValueFactory from which to construct the IonStruct representation of the LST

Returns:_Private_LocalSymbolTableFactory

a new LocalSymbolTableAsStruct.Factory

Annotations

@Deprecated

As per IonSystem#newSharedSymbolTable(String, int, Iterator, SymbolTable...), any duplicate or null symbol texts are skipped. Therefore, THIS METHOD IS NOT SUITABLE WHEN READING SERIALIZED SHARED SYMBOL TABLES since that scenario must preserve all sids.

Parameters

priorSymtab:SymbolTable

may be null.

Returns:SymbolTokenImpl

not null

Returns:SymbolTokenImpl

not null

Checks symbol content.

Returns:SymbolToken

not null

Returns:SymbolToken

not null

Validates each text element.

Parameters

text:String[]

may be null or empty.

Returns:SymbolToken[]

not null.

Parameters

syms:int[]

may be null or empty.

Returns:SymbolToken[]

not null.

Calls InputStream#read(byte[], int, int) until the buffer is filled or EOF is encountered. This method will block until the request is satisfied.

Parameters

in:InputStream

The stream to read from.

buf:byte[]

The buffer to read to.

Returns:int

the number of bytes read from the stream. May be less than buf.length if EOF is encountered before reading that far.

See Also

readFully(InputStream, byte[], int, int)

Calls InputStream#read(byte[], int, int) until the requested length is read or EOF is encountered. This method will block until the request is satisfied.

Parameters

in:InputStream

The stream to read from.

buf:byte[]

The buffer to read to.

offset:int

The offset of the buffer to read from.

length:int

The length of the data to read.

Returns:int

the number of bytes read from the stream. May be less than length if EOF is encountered before reading that far.

See Also

readFully(InputStream, byte[])

Determines whether the passed-in superset symtab is an extension of subset.

If both are LSTs, their imported tables and locally declared symbols are exhaustively checked, which can be expensive. Callers of this method should cache the results of these comparisons.

Parameters

superset:SymbolTable

either a system or local symbol table

subset:SymbolTable

either a system or local symbol table

Returns:boolean

true if superset extends subset, false if not

Indicates whether a table is shared but not a system table.

Annotations

@SuppressWarnings:deprecation

Extracts the non-null text from a list of symbol tokens.

Returns:String[]

not null.

Exceptions

UnknownSymbolException:

if any token is missing text.

Encodes a String into UTF-8 bytes.

This method is preferred to Charset#encode(String) and String#getBytes(String) (etc.) since those methods will replace or ignore bad input, and here we throw an exception.

Parameters

s:String

the string to encode.

Returns:byte[]

the encoded UTF-8 bytes, not null.

Exceptions

IonException:

if there's a CharacterCodingException.

Decodes a UTF-8 byte sequence to a String.

This method is preferred to Charset#decode(ByteBuffer) and String#String(byte[], Charset) (etc.) since those methods will replace or ignore bad input, and here we throw an exception.

Parameters

bytes:byte[]

the data to decode.

Returns:String

the decoded string, not null.

Exceptions

IonException:

if there's a CharacterCodingException.

Checks the passed in value and returns whether or not the value could be a local symbol table. It does this by checking the type and annotations.

Returns:boolean

boolean true if v can be a local symbol table otherwise false