FileDocCategorySizeDatePackage
StringIdsSection.javaAPI DocAndroid 5.1 API4902Thu Mar 12 22:18:30 GMT 2015com.android.dx.dex.file

StringIdsSection

public final class StringIdsSection extends UniformItemSection
Strings list section of a {@code .dex} file.

Fields Summary
private final TreeMap
strings
{@code non-null;} map from string constants to {@link StringIdItem} instances
Constructors Summary
public StringIdsSection(DexFile file)
Constructs an instance. The file offset is initially unknown.

param
file {@code non-null;} file that this instance is part of

        super("string_ids", file, 4);

        strings = new TreeMap<CstString, StringIdItem>();
Methods Summary
public IndexedItemget(com.android.dx.rop.cst.Constant cst)
{@inheritDoc}

        if (cst == null) {
            throw new NullPointerException("cst == null");
        }

        throwIfNotPrepared();

        IndexedItem result = strings.get((CstString) cst);

        if (result == null) {
            throw new IllegalArgumentException("not found");
        }

        return result;
public intindexOf(com.android.dx.rop.cst.CstString string)
Gets the index of the given string, which must have been added to this instance.

param
string {@code non-null;} the string to look up
return
{@code >= 0;} the string's index

        if (string == null) {
            throw new NullPointerException("string == null");
        }

        throwIfNotPrepared();

        StringIdItem s = strings.get(string);

        if (s == null) {
            throw new IllegalArgumentException("not found");
        }

        return s.getIndex();
public StringIdItemintern(java.lang.String string)
Interns an element into this instance.

param
string {@code non-null;} the string to intern, as a regular Java {@code String}
return
{@code non-null;} the interned string

        return intern(new StringIdItem(new CstString(string)));
public StringIdItemintern(com.android.dx.rop.cst.CstString string)
Interns an element into this instance.

param
string {@code non-null;} the string to intern, as a constant
return
{@code non-null;} the interned string

        return intern(new StringIdItem(string));
public StringIdItemintern(StringIdItem string)
Interns an element into this instance.

param
string {@code non-null;} the string to intern
return
{@code non-null;} the interned string

        if (string == null) {
            throw new NullPointerException("string == null");
        }

        throwIfPrepared();

        CstString value = string.getValue();
        StringIdItem already = strings.get(value);

        if (already != null) {
            return already;
        }

        strings.put(value, string);
        return string;
public voidintern(com.android.dx.rop.cst.CstNat nat)
Interns the components of a name-and-type into this instance.

param
nat {@code non-null;} the name-and-type

        intern(nat.getName());
        intern(nat.getDescriptor());
public java.util.Collectionitems()
{@inheritDoc}

        return strings.values();
protected voidorderItems()
{@inheritDoc}

        int idx = 0;

        for (StringIdItem s : strings.values()) {
            s.setIndex(idx);
            idx++;
        }
public voidwriteHeaderPart(com.android.dx.util.AnnotatedOutput out)
Writes the portion of the file header that refers to this instance.

param
out {@code non-null;} where to write

        throwIfNotPrepared();

        int sz = strings.size();
        int offset = (sz == 0) ? 0 : getFileOffset();

        if (out.annotates()) {
            out.annotate(4, "string_ids_size: " + Hex.u4(sz));
            out.annotate(4, "string_ids_off:  " + Hex.u4(offset));
        }

        out.writeInt(sz);
        out.writeInt(offset);