XMLオブジェクトを記述するクラスです。
各p5.XML
オブジェクトは、XMLデータと簡単に対話する方法を提供します。 拡張可能なマークアップ言語 (XML) は、アプリケーション間でデータを送信するための標準フォーマットです。HTMLと同様に、 XMLフォーマットはタグと属性に基づいています。例えば、 <time units="s">1234</time>
のようになります。
注意:外部XMLファイルを読み込むにはloadXML()を使用してください。
実例
メソッド
要素の名前をString
として返します。
XML要素の名前はそのタグによって与えられます。例えば、
という要素の名前は language
です。
要素のタグ名を設定します。
XML要素の名前はそのタグによって与えられます。例えば、
という要素の名前は language
です。
パラメータname
は、要素の新しい名前を文字列で指定します。例えば、 myXML.setName('planet')
を呼び出すと、要素の新しいタグ名が
になります。
要素に子要素がある場合はtrue
を、ない場合はfalse
を返します。
要素の子要素の名前をString
の配列として返します。
要素の子要素を新しいp5.XMLオブジェクトの配列として返します。
パラメータname
はオプションです。文字列が渡された場合、 例えばmyXML.getChildren('cat')
のように、
タグを持つ子要素のみを返します。
最初に一致する子要素を新しいp5.XMLオブジェクトとして返します。
パラメータname
はオプションです。文字列が渡された場合、 例えばmyXML.getChild('cat')
のように、
タグを持つ最初の子要素が返されます。数値が渡された場合、 例えばmyXML.getChild(1)
のように、そのインデックスの子要素が返されます。
新しい子要素を追加し、その参照を返します。
パラメータchild
は、子要素として追加するp5.XMLオブジェクトです。 例えば、myXML.addChild(otherXML)
を呼び出すと、 otherXML
がmyXML
の子要素として挿入されます。
最初に一致する子要素を削除します。
パラメータname
は、削除する子要素です。文字列が渡された場合、 例えばmyXML.removeChild('cat')
のように、
タグを持つ最初の子要素が削除されます。数値が渡された場合、 例えばmyXML.removeChild(1)
のように、そのインデックスの子要素が 削除されます。
要素が持つ属性の数を返します。
要素の属性名をArray
として返します。
注意:属性の値を返すには myXML.getString()または myXML.getNum()を使用してください。
要素が指定された属性を持っている場合はtrue
を、持っていない場合はfalse
を返します。
パラメータname
は、チェックする属性の名前を文字列で指定します。
注意:属性の値を返すには myXML.getString()または myXML.getNum()を使用してください。
属性の値をNumber
として返します。
最初のパラメータname
は、チェックする属性の名前を文字列で指定します。 例えば、myXML.getNum('id')
を呼び出すと、要素のid
属性を 数値として返します。
2番目のパラメータdefaultValue
はオプションです。数値が渡された場合、 例えばmyXML.getNum('id', -1)
のように、属性が存在しないか 数値に変換できない場合に返されます。
注意:属性の値を返すには myXML.getString()または myXML.getNum()を使用してください。
属性の値を文字列として返します。
最初のパラメータname
は、チェックする属性の名前を文字列で指定します。 例えば、myXML.getString('color')
を呼び出すと、要素のcolor
属性を 文字列として返します。
2番目のパラメータdefaultValue
はオプションです。文字列が渡された場合、 例えばmyXML.getString('color', 'deeppink')
のように、属性が存在しない場合に 返されます。
注意:属性の値を返すには myXML.getString()または myXML.getNum()を使用してください。
属性に指定された値を設定します。
最初のパラメータname
は、設定する属性の名前を文字列で指定します。
2番目のパラメータvalue
は、属性の新しい値です。例えば、 myXML.setAttribute('id', 123)
を呼び出すと、id
属性の値を 123に設定します。
要素のコンテンツをString
として返します。
パラメータdefaultValue
はオプションです。文字列が渡された場合、 例えばmyXML.getContent('???')
のように、要素にコンテンツがない場合に 返されます。
要素のコンテンツを設定します。
要素のコンテンツは、そのタグの間のテキストです。例えば、
という要素のコンテンツは JavaScript
です。
パラメータcontent
は、要素の新しいコンテンツを文字列で指定します。
要素をString
として返します。
myXML.serialize()
は、要素をネットワーク経由で送信したり ファイルに保存したりする際に便利です。