PBDOM_DOCUMENT:

GetElementsByTagName method

Description

Retrieves
all the elements in the XML document that have the specified TagName.

Syntax

<span>pbdom_object_name</span>.GetElementsByTagName(string <span>strTagName</span>, ref pbdom_element <span>pbdom_element_array</span>[])

1	<span>pbdom_object_name</span>.GetElementsByTagName(string <span>strTagName</span>, ref pbdom_element <span>pbdom_element_array</span>[])

Argument	Description
strTagName	The TagName of the elements to be searched for
pbdom_element_array[]	A reference to a PBDOM_ELEMENT object array that has the specified TagName

Return Values

Boolean. GetElementsByTagName returns true for
success and false if an exception occurs.

Examples

Assume a PBDOM_DOCUMENT contains the following
XML fragment:

&lt;book&gt;<br>&#160;&#160;&#160;&lt;title&gt;The Winter's Tale&lt;/title&gt;<br>&#160;&#160;&#160;&lt;author&gt;William Shakespeare&lt;/author&gt;<br>&#160;&#160;&#160;&lt;price&gt;7.95&lt;/price&gt;<br>&#160;&#160;&#160;&lt;quantity&gt;1&lt;/quantity&gt;<br>&lt;/book&gt;<br>&lt;book&gt;<br>&#160;&#160;&#160;&lt;title&gt;Le Lecon&lt;/title&gt;<br>&#160;&#160;&#160;&lt;author&gt;Eugene Ionesco&lt;/author&gt;<br>&#160;&#160;&#160;&lt;price&gt;10.95&lt;/price&gt;<br>&#160;&#160;&#160;&lt;quantity&gt;1&lt;/quantity&gt;<br>&lt;/book&gt;<br>&lt;book&gt;<br>&#160;&#160;&#160;&lt;title&gt;Deutsches Tempo&lt;/title&gt;<br>&#160;&#160;&#160;&lt;author&gt;Kurt Tucholsky&lt;/author&gt;<br>&#160;&#160;&#160;&lt;price&gt;13.95&lt;/price&gt;<br>&#160;&#160;&#160;&lt;quantity&gt;1&lt;/quantity&gt;<br>&lt;/book&gt;

<book>    <title>The Winter's Tale</title>    <author>William Shakespeare</author>    <price>7.95</price>    <quantity>1</quantity> </book> <book>    <title>Le Lecon</title>    <author>Eugene Ionesco</author>    <price>10.95</price>    <quantity>1</quantity> </book> <book>    <title>Deutsches Tempo</title>    <author>Kurt Tucholsky</author>    <price>13.95</price>    <quantity>1</quantity> </book>

The following statements extract the list of titles from the
document and display it in a multilineedit control:

pbdom_document doc<br>pbdom_element element[]<br> <br>// doc contains role elements<br>boolean bb_bool<br> <br>bb_bool = doc.getelementsbytagname("title",element[])<br> <br>integer ii_bound, i<br> <br>ii_bound = upperbound(element)<br>for i = 1 to ii_bound<br>&#160;&#160;&#160;mle_1.text += element[i].gettext() + "~r~n"<br>next

pbdom_document doc pbdom_element element[] // doc contains role elements boolean bb_bool bb_bool = doc.getelementsbytagname("title",element[]) integer ii_bound, i ii_bound = upperbound(element) for i = 1 to ii_bound    mle_1.text += element[i].gettext() + "~r~n" next

Document get from Powerbuilder help

Thank you for watching.

Powerbuilder Documentation 12.6

August 13, 2023

Was this article helpful?

Connection Information

GetElementsByTagName – PB Docs 126