added in API level 8

DOMStringList

public interface DOMStringList

org.w3c.dom.DOMStringList


The DOMStringList interface provides the abstraction of an ordered collection of DOMString values, without defining or constraining how this collection is implemented. The items in the DOMStringList are accessible via an integral index, starting from 0.

See also the Document Object Model (DOM) Level 3 Core Specification.

Summary

Public methods

abstract boolean contains(String str)

Test if a string is part of this DOMStringList.

abstract int getLength()

The number of DOMStrings in the list.

abstract String item(int index)

Returns the indexth item in the collection.

Public methods

contains

added in API level 8
public abstract boolean contains (String str)

Test if a string is part of this DOMStringList.

Parameters
str String: The string to look for.

Returns
boolean true if the string has been found, false otherwise.

getLength

added in API level 8
public abstract int getLength ()

The number of DOMStrings in the list. The range of valid child node indices is 0 to length-1 inclusive.

Returns
int

item

added in API level 8
public abstract String item (int index)

Returns the indexth item in the collection. If index is greater than or equal to the number of DOMStrings in the list, this returns null.

Parameters
index int: Index into the collection.

Returns
String The DOMString at the indexth position in the DOMStringList, or null if that is not a valid index.