If you do not know the name of an item or want to traverse the items in a document, use getItems in Document; getItems returns a vector of Item objects. As you access each vector element, use the Item methods to interrogate and manipulate the object.

To access an item whose name is known, use getFirstItem in Document. Items can have the same name, although this practice is discouraged; to access other than the first item, you must use getItems. Use hasItem in Document to determine if a document contains a named item.

From the Document level, getItemValueDouble, getItemValueInteger, and getItemValueString are convenient for obtaining the value of a numeric or text item that holds a single value. From the Item level, use getDateTimeValue, getValueDouble, getValueInteger, and getValueString to get a single date-time, numeric, or text value. Use getItemValue in Document and getValues in Item to get the values of a single or multi-value item; getItemValue and getValues return a vector of Object objects, which must be cast to DateTime, Double, Integer, or String. In Item, containsValue determines the existence of elements in multi-value text items.

Use getText of Item to get a text rendition of an item of any type. Multi-value items are rendered with a separator, typically the semicolon, between elements. Use abstract to get a condensed text rendition of an item.

Example
See Also

Accessing items in Java classes