New (XmlNodelist constructor): Difference between revisions
Jump to navigation
Jump to search
m (removed <p> tag after subtitle template include - this was messing up the formatting of the *syntax* template) |
mNo edit summary |
||
| (11 intermediate revisions by 3 users not shown) | |||
| 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. | |||
==Syntax== | ==Syntax== | ||
{{Template:XmlNodelist:New syntax}} | {{Template:XmlNodelist:New syntax}} | ||
===Syntax terms=== | ===Syntax terms=== | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr><th>% | <tr><th>%nodl</th> | ||
<td>A declared <var> | <td>A declared <var>XmlNodelist</var> object variable to contain the new <var>XmlNodelist</var> object instance.</td></tr> | ||
<tr><th>% | |||
<td> | <tr><th><var>[%(XmlNodelist):]</var></th> | ||
<tr><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> | |||
<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><var>New</var> can be invoked with no object | <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 with an object variable | |||
<p class="code">% | |||
% | %nodl = %(XmlNodelist):new(%doc) | ||
%nodl = %nodl:new(%doc) | |||
<var> | </p></li> | ||
(see [[ | |||
<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== | ==See also== | ||
{{Template:XmlNodelist:New footer}} | {{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).