Difference between revisions of "SHIP:Sail:getChild"

From Serious Documentation
Jump to: navigation, search
(→‎Detailed Description)
(→‎Detailed Description)
Line 26: Line 26:
 
== Detailed Description ==
 
== Detailed Description ==
  
−
Nodes in [[SHIP]] may have 0 or more child nodes.  For example, a {{Node|group}} in the {{Node|resources}} area may have N {{Node|image}}s within the {{Node|group}}.
+
The <code>getChild(parent, index)</code> function returns the child at <code>index</code> within the parent.
  
−
These children, if present, are implicitly numbered <code>0..(N-1)</code> where <code>N</code> is the total number of children of any type within the parent node.
+
Nodes in [[SHIP]] may have 0 or more child nodes.  For example, a {{Node|group}} in the {{Node|resources}} area may have N {{Node|image}}s within the {{Node|group}}. These children, if present, are implicitly numbered <code>0..(N-1)</code> where <code>N</code> is the total number of children of any type within the parent node.
−
 
 
−
The <code>getChild</code> function returns the child at <code>index</code> within the parent.
 
  
 
The <code>index</code> is always taken "modulus the count of children within the parent", preventing inadvertent out-of-bounds accesses.  For example, a reference to index <code>5</code> when the parent only has <code>4</code> children will return <code>5%4 => 1</code>.  Negative indices are handled also with a modulus.  Therefore, as expected, index <code>-1</code> returns the last child.
 
The <code>index</code> is always taken "modulus the count of children within the parent", preventing inadvertent out-of-bounds accesses.  For example, a reference to index <code>5</code> when the parent only has <code>4</code> children will return <code>5%4 => 1</code>.  Negative indices are handled also with a modulus.  Therefore, as expected, index <code>-1</code> returns the last child.

Revision as of 16:51, 4 December 2012

SHIP Sail Reference Home

getChild

Gets a child node object from within an enclosing parent node, by index.

Prototype

node = getChild(parentNode, index);

Parameters/Return Value

Parameter Data Type Description
parentNode Node The node to look in for children
index Integer The index of the child desired in the parent
Return Node nth node within the parentNode's children

Detailed Description

The getChild(parent, index) function returns the child at index within the parent.

Nodes in SHIP may have 0 or more child nodes. For example, a group in the resources area may have N images within the group. These children, if present, are implicitly numbered 0..(N-1) where N is the total number of children of any type within the parent node.

The index is always taken "modulus the count of children within the parent", preventing inadvertent out-of-bounds accesses. For example, a reference to index 5 when the parent only has 4 children will return 5%4 => 1. Negative indices are handled also with a modulus. Therefore, as expected, index -1 returns the last child.

If the specified parent node has no children, the parent object itself is returned by the function.

Examples

Retrieved from "https://techref.myserious.com/index.php?title=SHIP:Sail:getChild&oldid=1224"