com.android.dx.dex.file
Class StringDataItem

java.lang.Object
  com.android.dx.dex.file.Item
      com.android.dx.dex.file.OffsettedItem
          com.android.dx.dex.file.StringDataItem

All Implemented Interfaces:

Comparable<OffsettedItem>

public final class StringDataItem
extends OffsettedItem

Representation of string data for a particular string, in a Dalvik file.

Constructor Summary

StringDataItem(CstString value)
Constructs an instance.

Method Summary

void	addContents(DexFile file) Populates a DexFile with items from within this instance.
protected int	compareTo0(OffsettedItem other) Compares this instance to another which is guaranteed to be of the same class.
ItemType	itemType() Returns the item type for this instance.
String	toHuman() Gets a short human-readable string representing this instance.
void	writeTo0(DexFile file, AnnotatedOutput out) Performs the actual write of the contents of this instance to the given data section.

Methods inherited from class com.android.dx.dex.file.OffsettedItem

compareTo, equals, getAbsoluteOffset, getAbsoluteOffsetOr0, getAlignment, getRelativeOffset, offsetString, place, place0, setWriteSize, writeSize, writeTo

Methods inherited from class com.android.dx.dex.file.Item

typeName

Methods inherited from class java.lang.Object

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

Constructor Detail

StringDataItem

public StringDataItem(CstString value)

Constructs an instance.

Parameters:

value - non-null; the string value

Method Detail

itemType

public ItemType itemType()

Returns the item type for this instance.

Specified by:

itemType in class Item

Returns:

non-null; the item type

addContents

public void addContents(DexFile file)

Populates a DexFile with items from within this instance. This will not add an item to the file for this instance itself (which should have been done by whatever refers to this instance).

Note: Subclasses must override this to do something appropriate.

Specified by:

addContents in class Item

Parameters:

file - non-null; the file to populate

writeTo0

public void writeTo0(DexFile file,
                     AnnotatedOutput out)

Performs the actual write of the contents of this instance to the given data section. This is called by OffsettedItem.writeTo(com.android.dx.dex.file.DexFile, com.android.dx.util.AnnotatedOutput), which will have taken care of ensuring alignment.

Specified by:

writeTo0 in class OffsettedItem

Parameters:

file - non-null; the file to use for reference

out - non-null; where to write to

toHuman

public String toHuman()

Gets a short human-readable string representing this instance.

Specified by:

toHuman in class OffsettedItem

Returns:

non-null; the human form

compareTo0

protected int compareTo0(OffsettedItem other)

Compares this instance to another which is guaranteed to be of the same class. The default implementation of this method is to throw an exception (unsupported operation). If a particular class needs to actually sort, then it should override this method.

Overrides:

compareTo0 in class OffsettedItem

Parameters:

other - non-null; instance to compare to

Returns:

-1, 0, or 1, depending on the sort order of this instance and the other