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