summaryrefslogtreecommitdiff
path: root/lib/rexml/child.rb
blob: 6d3c9df5e6a15a7e9c85b986539319da492ec3e1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
require "rexml/node"

module REXML
	##
	# A Child object is something contained by a parent, and this class
	# contains methods to support that.  Most user code will not use this
	# class directly.
	class Child
		include Node
		attr_reader :parent		# The Parent of this object

		# Constructor.  Any inheritors of this class should call super to make
		# sure this method is called.
		# parent::
		#   if supplied, the parent of this child will be set to the
		#   supplied value, and self will be added to the parent
		def initialize( parent = nil )
			@parent = nil  
			# Declare @parent, but don't define it.  The next line sets the 
			# parent.
			parent.add( self ) if parent
		end

		# Replaces this object with another object.  Basically, calls
		# Parent.replace_child
		#
		# Returns:: self
		def replace_with( child )
			@parent.replace_child( self, child )
			self
		end

		# Removes this child from the parent.
		#
		# Returns:: self
		def remove
			unless @parent.nil?
				@parent.delete self
			end
			self
		end

		# Sets the parent of this child to the supplied argument.
		#
		# other::
		#   Must be a Parent object.  If this object is the same object as the
		#   existing parent of this child, no action is taken. Otherwise, this
		#   child is removed from the current parent (if one exists), and is added
		#   to the new parent.
		# Returns:: The parent added
		def parent=( other )
			return @parent if @parent == other
			@parent.delete self if defined? @parent and @parent
			@parent = other
		end

		alias :next_sibling :next_sibling_node
		alias :previous_sibling :previous_sibling_node

		# Sets the next sibling of this child.  This can be used to insert a child
		# after some other child.
		#  a = Element.new("a")
		#  b = a.add_element("b")
		#  c = Element.new("c")
		#  b.next_sibling = c
		#  # => <a><b/><c/></a>
		def next_sibling=( other )
		  parent.insert_after self, other
		end

		# Sets the previous sibling of this child.  This can be used to insert a 
		# child before some other child.
		#  a = Element.new("a")
		#  b = a.add_element("b")
		#  c = Element.new("c")
		#  b.previous_sibling = c
		#  # => <a><b/><c/></a>
		def previous_sibling=(other)
		  parent.insert_before self, other
		end

		# Returns:: the document this child belongs to, or nil if this child
		# belongs to no document
		def document
			return parent.document unless parent.nil?
			nil
		end

		# This doesn't yet handle encodings
		def bytes
			encoding = document.encoding

			to_s
		end
	end
end