File Manager

== Module Node

:include: ../tocs/node_toc.rdoc

=== Siblings

==== Task: Find Previous Sibling

Use method
{Node.previous_sibling_node}[../../../../REXML/Node.html#method-i-previous_sibling]
to retrieve the previous sibling:

  d = REXML::Document.new('<root><a/><b/><c/></root>')
  b = d.root[1]           # => <b/>
  b.previous_sibling_node # => <a/>

==== Task: Find Next Sibling

Use method
{Node.next_sibling_node}[../../../../REXML/Node.html#method-i-next_sibling]
to retrieve the next sibling:

  d = REXML::Document.new('<root><a/><b/><c/></root>')
  b = d.root[1]       # => <b/>
  b.next_sibling_node # => <c/>

=== Position

==== Task: Find Own Index Among Siblings

Use method
{Node.index_in_parent}[../../../../REXML/Node.html#method-i-index_in_parent]
to retrieve the 1-based index of this node among its siblings:

  d = REXML::Document.new('<root><a/><b/><c/></root>')
  b = d.root[1]     # => <b/>
  b.index_in_parent # => 2

=== Recursive Traversal

==== Task: Traverse Each Recursively

Use method
{Node.each_recursive}[../../../../REXML/Node.html#method-i-each_recursive]
to traverse a tree of nodes recursively:

  xml_string = '<root><a><b><c></c></b><b><c></c></b></a></root>'
  d = REXML::Document.new(xml_string)
  d.root.each_recursive {|node| p node }

Output:

  <a> ... </>
  <b> ... </>
  <c/>
  <b> ... </>
  <c/>

=== Recursive Search

==== Task: Traverse Each Recursively

Use method
{Node.find_first_recursive}[../../../../REXML/Node.html#method-i-find_first_recursive]
to search a tree of nodes recursively:

  xml_string = '<root><a><b><c></c></b><b><c></c></b></a></root>'
  d = REXML::Document.new(xml_string)
  d.root.find_first_recursive {|node| node.name == 'c' } # => <c/>

=== Representation

==== Task: Represent a String

Use method {Node.to_s}[../../../../REXML/Node.html#method-i-to_s]
to represent the node as a string:

  xml_string = '<root><a><b><c></c></b><b><c></c></b></a></root>'
  d = REXML::Document.new(xml_string)
  d.root.to_s # => "<root><a><b><c/></b><b><c/></b></a></root>"

=== Parent?

==== Task: Determine Whether the Node is a Parent

Use method {Node.parent?}[../../../../REXML/Node.html#method-i-parent-3F]
to determine whether the node is a parent;
class Text derives from Node:

  d = REXML::Document.new('<root><a/>text<b/>more<c/></root>')
  t = d.root[1] # => "text"
  t.parent?     # => false

Class Parent also derives from Node, but overrides this method:

  p = REXML::Parent.new
  p.parent? # => true