Ruby 2.3.0 リファレンスマニュアル > ライブラリ一覧 > rexml/documentライブラリ > REXML::Attributesクラス

class REXML::Attributes

クラスの継承リスト: REXML::Attributes < Hash < Enumerable < Object < Kernel < BasicObject

要約

属性の集合を表すクラスです。

REXML::Element#attributes はこのクラスのオブジェクトを返します。 各属性には REXML::Attributes#[] でアクセスします。

目次

特異メソッド

new

インスタンスメソッド

<< add [] []= delete delete_all each each_attribute get_attribute get_attribute_ns length size namespaces prefixes to_a

特異メソッド

new(element) -> REXML::Attributes[permalink][rdoc]

空の Attributes オブジェクトを生成します。

どの要素の属性であるかを element で指定します。

通常は REXML::Element.new によって Attributes オブジェクト が生成されるため、このメソッドを使う必要はありません。

[PARAM] element:

属性が属する要素(REXML::Element オブジェクト)

インスタンスメソッド

add(attribute) -> ()[permalink][rdoc]

self << attribute -> ()

属性を追加/更新します。

attribute で更新する属性(REXML::Attribute オブジェクト)を 指定します。既に同じ名前(REXML::Attribute#name)のオブジェクトが 存在する場合は属性が上書きされ、ない場合は追加されます。

[PARAM] attribute:

追加(更新)する属性(REXML::Attribute オブジェクト)

[SEE_ALSO] REXML::Attributes#[]=

self[name] -> String | nil[permalink][rdoc]

属性名nameの属性値を返します。

属性値ではなく REXML::Attribute オブジェクトが必要な場合は REXML::Attributes#get_attribute を使ってください。

nameという属性名の属性がない場合は nil を返します。

[PARAM] name:

属性名(文字列)

例

require 'rexml/document'

doc = REXML::Document.new(<<EOS)
<root xmlns:foo="http://example.org/foo"
      xmlns:bar="http://example.org/bar">
  <a foo:att='1' bar:att='2' att='&lt;'/>
</root>
EOS

a = doc.get_elements("/root/a").first

p a.attributes["att"] # => "<"
p a.attributes["bar:att"] # => "2"

self[name] = value[permalink][rdoc]

指定した属性を更新します。

name で属性の名前を、value で値を更新します。 既に同じ名前の属性がある場合は上書きされ、 そうでない場合は属性が追加されます。

例

require 'rexml/document'

doc = REXML::Document.new(<<-EOS)
<root xmlns:foo="http://example.org/foo"
      xmlns:bar="http://example.org/bar">
  <a foo:att='1' bar:att='2' att='&lt;'/>
</root>
EOS
a = doc.get_elements("/root/a").first

a.attributes["att"] = "9"
a.attributes["foo:attt"] = "8"
a # => <a foo:att='1' bar:att='2' att='9' foo:attt='8'/>

[SEE_ALSO] REXML::Attributes#add

delete(attribute) -> REXML::Element[permalink][rdoc]

指定した属性を取り除きます。

attribute で取り除く属性を指定します。 文字列もしくは REXML::Attribute オブジェクトを指定します

self が属する要素(REXML::Element)を返します。

[PARAM] attribute:

取り除く属性(文字列もしくは REXML::Attribute オブジェクト)

例

require 'rexml/document'

doc = REXML::Document.new(<<-EOS)
<root xmlns:foo="http://example.org/foo"
      xmlns:bar="http://example.org/bar">
  <a foo:att='1' bar:att='2' att='&lt;'/>
</root>
EOS
a = doc.get_elements("/root/a").first

a.attributes.delete("att")     # => <a foo:att='1' bar:att='2'/>
a.attributes.delete("foo:att") # => <a bar:att='2'/>
attr = a.attributes.get_attribute("bar:att")
a.attributes.delete(attr)      # => <a/>

delete_all(name) -> [REXML::Attribute][permalink][rdoc]

name という名前を持つ属性をすべて削除します。

削除された属性を配列で返します。

[PARAM] name:

削除する属性の名前

例

require 'rexml/document'

doc = REXML::Document.new(<<-EOS)
<root xmlns:foo="http://example.org/foo"
      xmlns:bar="http://example.org/bar">
  <a foo:att='1' bar:att='2' att='&lt;'/>
</root>
EOS
a = doc.get_elements("/root/a").first

a.attributes.delete_all("att") # => [att='&lt;']
a # => <a foo:att='1' bar:att='2'/>

each {|name, value| ... } -> ()[permalink][rdoc]

各属性の名前と値に対しブロックを呼び出します。

名前には expanded_name(REXML::Namespace#exapnded_name)が 渡されます。

例

require 'rexml/document'

doc = REXML::Document.new(<<EOS)
<root xmlns:foo="http://example.org/foo"
      xmlns:bar="http://example.org/bar">
  <a foo:att='1' bar:att='2' att='&lt;'/>
</root>
EOS
a = doc.get_elements("/root/a").first

a.attributes.each do |name, value|
  p [name, value]
end

# => ["foo:att", "1"]
# => ["bar:att", "2"]
# => ["att", "<"]

each_attribute {|attribute| ... } -> ()[permalink][rdoc]

各属性に対しブロックを呼び出します。

個々の属性は REXML::Attribute オブジェクトで渡されます。

例

require 'rexml/document'

doc = REXML::Document.new(<<EOS)
<root xmlns:foo="http://example.org/foo"
      xmlns:bar="http://example.org/bar">
  <a foo:att='1' bar:att='2' att='&lt;'/>
</root>
EOS
a = doc.get_elements("/root/a").first

a.attributes.each_attribute do |attr|
  p [attr.namespace, attr.name, attr.value]
end
# => ["http://example.org/foo", "att", "1"]
# => ["http://example.org/bar", "att", "2"]
# => ["", "att", "<"]

get_attribute(name) -> Attribute | nil[permalink][rdoc]

name という名前の属性を取得します。

name という名前を持つ属性がない場合は nil を返します。

[PARAM] name:

属性名(文字列)

[SEE_ALSO] REXML::Attributes#[]

例

require 'rexml/document'

doc = REXML::Document.new(<<-EOS)
<root xmlns:foo="http://example.org/foo"
      xmlns:bar="http://example.org/bar">
  <a foo:att='1' bar:att='2' att='&lt;'/>
</root>
EOS
a = doc.get_elements("/root/a").first

a.attributes.get_attribute("att") # => att='&lt;'
a.attributes.get_attribute("foo:att") # => foo:att='1'

get_attribute_ns(namespace, name) -> REXML::Attribute | nil[permalink][rdoc]

namespace と name で特定される属性を返します。

namespace で名前空間を、 name で prefix を含まない属性名を 指定します。

指定された属性が存在しない場合は nil を返します。

XML プロセッサが prefix を置き換えてしまった場合でも、このメソッドを 使うことで属性を正しく指定することができます。

[PARAM] namespace:

名前空間(URI, 文字列)

[PARAM] name:

属性名(文字列)

例

require 'rexml/document'

doc = REXML::Document.new(<<-EOS)
<root xmlns:foo="http://example.org/foo"
      xmlns:bar="http://example.org/bar">
  <a foo:att='1' bar:att='2' att='&lt;'/>
</root>
EOS
a = doc.get_elements("/root/a").first

a.attributes.get_attribute_ns("", "att") # => att='&lt;'
a.attributes.get_attribute_ns("http://example.org/foo", "att") # => foo:att='1'
a.attributes.get_attribute_ns("http://example.org/baz", "att") # => nil
a.attributes.get_attribute_ns("http://example.org/foo", "attt") # => nil

length -> Integer[permalink][rdoc]

size -> Integer

属性の個数を返します。

例

require 'rexml/document'

doc = REXML::Document.new(<<EOS)
<root xmlns:foo="http://example.org/foo"
      xmlns:bar="http://example.org/bar">
  <a foo:att='1' bar:att='2' att='&lt;'/>
</root>
EOS
a = doc.get_elements("/root/a").first

p a.attributes.length # => 3

namespaces -> { String => String }[permalink][rdoc]

self の中で宣言されている名前空間の集合を返します。

返り値は名前空間の prefix をキーとし、URI を値とする Hash を返します。

例

require 'rexml/document'

doc = REXML::Document.new(<<EOS)
<root xmlns:foo="http://example.org/foo"
      xmlns:bar="http://example.org/bar">
  <a foo:att='1' bar:att='2' att='&lt;'/>
</root>
EOS
a = doc.get_elements("/root/a").first

p doc.root.attributes.namespaces
# => {"foo"=>"http://example.org/foo", "bar"=>"http://example.org/bar"}
p a.attributes.namespaces
# => {}

prefixes -> [String][permalink][rdoc]

self の中で宣言されている prefix の集合を 文字列の配列で返します。

self が属する要素より上位の要素で定義されているものは含みません。

例

require 'rexml/document'

doc = REXML::Document.new(<<EOS)
<root xmlns:foo="http://example.org/foo"
      xmlns:bar="http://example.org/bar">
  <a foo:att='1' bar:att='2' att='&lt;'/>
</root>
EOS
a = doc.get_elements("/root/a").first

p doc.root.attributes.prefixes # => ["foo", "bar"]
p a.attributes.prefixes # => []

to_a -> [Attribute][permalink][rdoc]

属性の配列を返します。

例

require 'rexml/document'
doc = REXML::Document.new("<a x='1' y='2' z='3' />")
doc.root.attributes.to_a # => [x='1', y='2', z='3']