Constructor arg if a String, the content is set to the String. If
a Text, the object is shallowly cloned.
respect_whitespace (boolean, false) if true, whitespace is
respected
parent (nil) if this is a Parent object,
the parent will be set to this.
raw (nil) This argument can be given three values. If true, then
the value of used to construct this object is expected to contain no
unescaped XML markup, and REXML will not change
the text. If this value is false, the string may contain any characters,
and REXML will escape any and all defined
entities whose values are contained in the text. If this value is nil (the
default), then the raw value of the parent will be used as the raw value
for this node. If there is no raw value for the parent, and no value is
supplied, the default is false.
Text.new( "<&", false, nil, false ) #-> "<&"
Text.new( "<&", false, nil, true ) #-> IllegalArgumentException
Text.new( "<&", false, nil, true ) #-> "<&"
# Assume that the entity "s" is defined to be "sean"
# and that the entity "r" is defined to be "russell"
Text.new( "sean russell" ) #-> "&s; &r;"
Text.new( "sean russell", false, nil, true ) #-> "sean russell"
entity_filter (nil) This can be an array of entities to match in
the supplied text. This argument is only useful if raw is set to
false.
Text.new( "sean russell", false, nil, false, ["s"] ) #-> "&s; russell"
Text.new( "sean russell", false, nil, true, ["s"] ) #-> "sean russell"
In the last example, the entity_filter argument is ignored.
pattern INTERNAL USE ONLY
Returns the string value of this text node. This string is always escaped,
meaning that it is a valid XML text node string, and all entities that can
be escaped, have been inserted. This method respects the entity filter set
in the constructor.
# Assume that the entity "s" is defined to be "sean", and that the
# entity "r" is defined to be "russell"
t = Text.new( "< & sean russell", false, nil, false, ['s'] )
t.to_s #-> "< & &s; russell"
t = Text.new( "< & &s; russell", false, nil, false )
t.to_s #-> "< & &s; russell"
u = Text.new( "sean russell", false, nil, true )
u.to_s #-> "sean russell"
Returns the string value of this text. This is the text without entities,
as it might be used programmatically, or printed to the console. This
ignores the ‘raw’ attribute setting, and any entity_filter.
# Assume that the entity "s" is defined to be "sean", and that the
# entity "r" is defined to be "russell"
t = Text.new( "< & sean russell", false, nil, false, ['s'] )
t.string #-> "< & sean russell"
t = Text.new( "< & &s; russell", false, nil, false )
t.string #-> "< & sean russell"
u = Text.new( "sean russell", false, nil, true )
u.string #-> "sean russell"
Writes out text, substituting special characters beforehand. out A
String, IO, or any other object supporting <<( String )
input the text to substitute and the write out
z=utf8.unpack("U*")
ascOut=""
z.each{|r|
if r < 0x100
ascOut.concat(r.chr)
else
ascOut.concat(sprintf("&#x%x;", r))
end
}
puts ascOut