com.oracle.objectfile.debugentry

Class StringTable

java.lang.Object

com.oracle.objectfile.debugentry.StringTable

All Implemented Interfaces:

Iterable<StringEntry>

public class StringTable
extends Object
implements Iterable<StringEntry>

Allows incoming strings to be reduced to unique (up to equals) instances and supports marking of strings which need to be written to the debug_str section and retrieval of the location offset after writing.

Constructor Summary

Constructors

Constructor and Description
StringTable()

Method Summary

Modifier and Type	Method and Description
int	debugStringIndex(String string) Retrieves the offset at which a given string was written into the debug_str section.
Iterator<StringEntry>	iterator()
String	uniqueDebugString(String string) Ensures a unique instance of a string exists in the table and is marked for inclusion in the debug_str section, inserting the supplied String if no equivalent String is already present.
String	uniqueString(String string) Ensures a unique instance of a string exists in the table, inserting the supplied String if no equivalent String is already present.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

StringTable

public StringTable()

Method Detail

uniqueString

public String uniqueString(String string)

Ensures a unique instance of a string exists in the table, inserting the supplied String if no equivalent String is already present. This should only be called before the string section has been written.

Parameters:

string - the string to be included in the table

Returns:

the unique instance of the String

uniqueDebugString

public String uniqueDebugString(String string)

Ensures a unique instance of a string exists in the table and is marked for inclusion in the debug_str section, inserting the supplied String if no equivalent String is already present. This should only be called before the string section has been written.

Parameters:

string - the string to be included in the table and marked for inclusion in the debug_str section

Returns:

the unique instance of the String

debugStringIndex

public int debugStringIndex(String string)

Retrieves the offset at which a given string was written into the debug_str section. This should only be called after the string section has been written.

Parameters:

string - the strng whose offset is to be retrieved

Returns:

the offset or -1 if the string does not define an entry or the entry has not been written to the debug_str section

iterator

public Iterator<StringEntry> iterator()

Specified by:

iterator in interface Iterable<StringEntry>