Description
Retrieves a list of names taken from the part of the PBDOM_PROCESSINGINSTRUCTION object's data that is factored into name="value" pairs. This method can be used in conjunction with the GetValue method.
Syntax
pbdom_pi_name.GetNames(string name_array[ ])
|
Argument |
Description |
|---|---|
|
pbdom_pi_name |
The name of a PBDOM_PROCESSINGINSTRUCTION object |
|
name_array |
An unbounded string array filled with names |
Return value
Boolean.
Returns true if a list of names is retrieved, and false otherwise. If there are no name/value pairs, this method returns false.
Examples
Given the following PBDOM_PROCESSINGINSTRUCTION object, GetNames returns three strings, a, b, and c, even though a occurs more than once:
<? dw-set_values a="1" b="2" c="3" a="4" ?>
When the GetValue method is called on a, the value 4 is returned, because it is the last value set for a.
Usage
If a name is used more than once as the name of a name/value pair in a PBDOM_PROCESSINGINSTRUCTION object, then the value set in the last occurrence of the name is used, and values declared in all previous occurrences of the name are discarded.
