New (XmlNodelist constructor): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
mNo edit summary
 
(22 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Template:XmlNodelist:New subtitle}}
{{Template:XmlNodelist:New subtitle}}
[[Category:XmlNodelist methods|New constructor]]
<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.
[[Category:XmlDoc API methods]]
 
<p>
This method creates an XmlNodelist object instance and takes one argument: the XmlDoc with which the XmlNodelist is associated.
==Syntax==
==Syntax==
{{Template:XmlNodelist:New syntax}}
{{Template:XmlNodelist:New syntax}}
===Syntax terms===
===Syntax terms===
<table class="syntaxTable">
<table class="syntaxTable">
<tr><th><i>%xmldoc</i></th>
<tr><th>%nodl</th>
<td>A declared XmlDoc object variable to contain the new XmlDoc 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><i>%xmlnlis</i></th>
 
<td>A declared XmlNodelist object variable to contain the new XmlNodelist object instance. </td></tr>
<tr><th><var>[%(XmlNodelist):]</var></th>
<tr><th><i>%doc</i></th>
<td>The optional class name in parentheses denotes a <var>[[Notation conventions for methods#Constructors|Constructor]]</var>.  See [[#Usage notes|Usage notes]], below, for more information about invoking an <var>XmlNodelist</var> <var>Constructor</var>.</td></tr>
<td>A XmlDoc object variable which references the XmlDoc with which ''%xmlnlis'' is associated.</td></tr>
 
<tr><th>doc</th>
<td>An <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>New can be invoked with no object (as in the syntax box above),
<li>As described in [[Object variables#Using New or other Constructors|Using New or other Constructors]], <var>New</var> can be invoked with no object, with an explicit class name, or with an object variable in the class, even if that object is <var>Null</var>:<p class="code">%nodl = new(%doc)
or alternatively as shown below, with an explicit class name
or with an object variable (even if that object is null):
<pre>
    %xmldoc = %(XmlDoc):new


    %xmlnlis = %xmlnlis:new(%doc)
%nodl = %(XmlNodelist):new(%doc)
</pre>
<li>Besides explicit New statements, XmlNodelists can be created by other
XML methods (for example, see [[SelectNodes (XmlDoc/XmlNode function)|SelectNodes]],
[[??]] reftxt=UnionSelected refid=unionsl.,
and [[??]] reftxt=Difference refid=diff.).


An XmlDoc can only be instantiated by the New method, although an
%nodl = %nodl:new(%doc)
XmlDoc can be returned or duplicated by a method
</p></li>
(see [[??]] reftxt=XmlDoc refid=xdocfn. and [[??]] reftxt=Copy refid=copydoc.).
 
<li>Besides explicit <var>New</var> statements, <var>XmlNodelist</var>s can be created by other XML methods (for example, see <var>[[SelectNodes (XmlDoc/XmlNode function)|SelectNodes]]</var>, <var>[[UnionSelected_(XmlNodelist_function)|UnionSelected]]</var>, and <var>[[Difference_(XmlNodelist_function)|Difference]]</var>). </li>
</ul>
</ul>
==See also==
{{Template:XmlNodelist:New footer}}

Latest revision as of 20:56, 15 January 2015

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.
[%(XmlNodelist):] The optional class name in parentheses denotes a Constructor. See Usage notes, below, for more information about invoking an XmlNodelist Constructor.
doc An XmlDoc object variable which references the XmlDoc with which %nodl is associated.

Usage notes

  • As described in Using New or other Constructors, New can be invoked with no object, with an explicit class name, or with an object variable in the class, even if that object is Null:

    %nodl = new(%doc) %nodl = %(XmlNodelist):new(%doc) %nodl = %nodl:new(%doc)

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

See also