GetNames
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
|
1 |
pbdom_pi_name.GetNames(string name_array[ ]) |
|
Argument |
Description |
|---|---|
|
pbdom_pi_name |
The name of a PBDOM_PROCESSINGINSTRUCTION |
|
name_array |
An unbounded string array filled with |
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:
|
1 |
<? 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.