New (XmlNodelist constructor): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (removed <p> tag after subtitle template include - this was messing up the formatting of the *syntax* template)
m (edits, tags and links)
Line 1: Line 1:
{{Template:XmlNodelist:New subtitle}}
{{Template:XmlNodelist:New subtitle}}
<var>New</var> creates an <var>XmlNodelist</var> object instance, taking one argument: the <var>XmlDoc</var> with which the <var>XmlNodelist</var> is associated.


This method creates an <var>XmlNodelist</var> object instance and takes one argument: the <var>XmlDoc</var> with which the <var>XmlNodelist</var> is associated.
==Syntax==
==Syntax==
{{Template:XmlNodelist:New syntax}}
{{Template:XmlNodelist:New syntax}}
===Syntax terms===
===Syntax terms===
<table class="syntaxTable">
<table class="syntaxTable">
<tr><th>%xmldoc</th>
<tr><th>%nodl</th>
<td>A declared <var>XmlDoc</var> object variable to contain the new <var>XmlDoc</var> object instance. </td></tr>
<td>A declared <var>XmlNodelist</var> object variable to contain the new <var>XmlNodelist</var> object instance.</td></tr>
<tr><th>%xmlnlis</th>
<td>A declared <var>XmlNodelist</var> object variable to contain the new <var>XmlNodelist</var> object instance. </td></tr>
<tr><th>%doc</th>
<tr><th>%doc</th>
<td>A <var>XmlDoc</var> object variable which references the <var>XmlDoc</var> with which ''%xmlnlis'' is associated.</td></tr>
<td>A <var>XmlDoc</var> object variable which references the <var>XmlDoc</var> with which <var class="term">%nodl</var> is associated.</td></tr>
</table>
</table>
==Usage notes==
==Usage notes==
<ul>
<ul>
<li><var>New</var> can be invoked with no object (as in the syntax box above),
<li><var>New</var> can be invoked with no object (as in the syntax box above), or alternatively as shown below, with an explicit class name or with an object variable (even if that object is null):
or alternatively as shown below, with an explicit class name
<p class="code">%xmlnlis = %xmlnlis:new(%doc)
or with an object variable (even if that object is null):
<p class="code">%xmldoc = %(<var>XmlDoc</var>):new
 
%xmlnlis = %xmlnlis:new(%doc)
</p>
</p>
<li>Besides explicit <var>New</var> statements, <var>XmlNodelist</var>s can be created by other
<li>Besides explicit <var>New</var> statements, <var>XmlNodelist</var>s can be created by other XML methods (for example, see [[SelectNodes (XmlDoc/XmlNode function)|SelectNodes]], [[UnionSelected_(XmlNodelist_function)|UnionSelected]], and [[Difference_(XmlNodelist_function)|Difference]]).
XML methods (for example, see [[SelectNodes (XmlDoc/XmlNode function)|SelectNodes]],
</ul>
[[??]] reftxt=UnionSelected refid=unionsl.,
and [[??]] reftxt=Difference refid=diff.).


An <var>XmlDoc</var> can only be instantiated by the <var>New</var> method, although an
<var>XmlDoc</var> can be returned or duplicated by a method
(see [[??]] reftxt=XmlDoc refid=xdocfn. and [[??]] reftxt=Copy refid=copydoc.).
</ul>
==See also==
==See also==
{{Template:XmlNodelist:New footer}}
{{Template:XmlNodelist:New footer}}

Revision as of 12:20, 27 April 2011

Create a new XmlNodelist (XmlNodelist class)

New creates an XmlNodelist object instance, taking one argument: the XmlDoc with which the XmlNodelist is associated.

Syntax

%nodl = [%(XmlNodelist):]New( doc)

Syntax terms

%nodl A declared XmlNodelist object variable to contain the new XmlNodelist object instance.
%doc A XmlDoc object variable which references the XmlDoc with which %nodl is associated.

Usage notes

  • New can be invoked with no object (as in the syntax box above), or alternatively as shown below, with an explicit class name or with an object variable (even if that object is null):

    %xmlnlis = %xmlnlis:new(%doc)

  • Besides explicit New statements, XmlNodelists can be created by other XML methods (for example, see SelectNodes, UnionSelected, and Difference).

See also