singleton method REXML::Element.new

new(arg = UNDEFINED, parent = nil, context = nil) -> REXML::Element[permalink][rdoc][edit]

要素オブジェクトを生成します。

arg が文字列の場合、新たな要素の名前は arg に設定されます。 arg が REXML::Element オブジェクトの場合は、新たな要素の名前、属性、context が arg のもので初期化されます。

parent で親ノードを指定します。

context には hash table で要素のコンテキストを指定します。基本的には text node (REXML::Text) での特別な文字、特に空白についての取り扱いを指定できます。以下の Symbol をハッシュのキーとして使います。

:respect_whitespace

空白を考慮して欲しい要素の名前の集合を文字列の配列で指定します。また、すべての要素で空白を考慮して欲しい場合には :all を指定します。デフォルト値は :all です。 REXML::Element#whitespace も参照してください。

:compress_whitespace

空白を無視して欲しい要素の名前の集合を文字列の配列で指定します。この指定は :respect_whitespace での指定を上書きします。すべての要素で空白を無視して欲しい場合には :all を指定します。 REXML::Element#whitespace も参照してください。

:ignore_whitespace_nodes

空白のみからなるノードを無視して欲しい要素の名前の集合を文字列の配列で指定します。すべての要素で無視して欲しい場合は :all を指定します。これが設定された場合、空白のみからなる text node は追加されません。 REXML::Element#ignore_whitespace_nodes も参照してください。

:raw

raw mode で取り扱いをして欲しい要素の名前の集合を文字列の配列で指定します。すべてのノードを raw mode で取り扱って欲しい場合は :all を指定します。 raw mode においては、text 中の特殊文字は一切変換されません。 REXML::Element#raw も参照してください。

[PARAM] arg:
要素の名前(String)もしくは初期化に使う REXML::Element オブジェクト
[PARAM] parent:
親ノード
[PARAM] context:
コンテキスト(Hash)

[SEE_ALSO] REXML::Parent.new, REXML::Child.new