オブジェクトXmlテキスト
XmlText オブジェクトは、要素または属性のテキスト コンテンツを表します。
XmlText ノードは、XML ドキュメント内の一連のプレーン テキストを表します。プレーン テキストは XML 要素および属性に表示されるため、通常、XmlText ノードはXmlElementノード合計XmlAttrノードの子が表示されます。
XmlText ノードは継承しますXmlCharacterDataインターフェース経由XmlCharacterDataインターフェースまたはから継承されたデータ属性XmlNodeインターフェイスによって継承された nadevalue 属性は、XmlText ノードのテキスト コンテンツにアクセスできます。
から使用しますXmlCharacterData継承されたメソッド、または XmlText インターフェイス自体によって定義された SplitText() メソッドは、XmlText ノードを操作できます。使用XmlDocumentcreateTextNode を使用して、新しい XmlText ノードを作成します。
XmlText ノードには子ノードがありません。
空の XmlText ノードを削除し、ドキュメントのサブツリーから隣接する XmlText ノードを結合する方法については、「」を参照してください。XmlNode.normalize方法。
相続関係
メンバーのプロパティ
data
文字列、このノードに含まれるテキスト
1String XmlText.data;
length
整数、このノードに含まれる文字数
1readonly Integer XmlText.length;
nodeType
整数。ノードのノード タイプを返します。
1readonly Integer XmlText.nodeType;
オブジェクトが異なると、nodeType も異なる値を返します。
- XmlElement: ELEMENT_NODE(1)
- XmlAttr:ATTRIBUTE_NODE(2)
- XmlText: TEXT_NODE(3)
- XmlCDATASection: CDATA_SECTION_NODE(4)
- XmlProcessingInstruction: PROCESSING_INSTRUCTION_NODE(7)
- XmlComment:COMMENT_NODE(8)
- XmlDocument: ドキュメント_NODE(9)
- XmlDocumentType: ドキュメントタイプ_NODE(10)
nodeName
文字列。タイプに応じてノードの名前を返します。
1readonly String XmlText.nodeName;
オブジェクトが異なると、nodeName も異なる値を返します。
- XmlElement:要素名
- XmlAttr: 属性名
- XmlText: #文章
- XmlCDATASection: #cdata-セクション
- XmlProcessingInstruction: 指定されたターゲット target を返します。
- XmlComment: #コメント
- XmlDocument: #書類
- XmlDocumentType: ドキュメントタイプ名
nodeValue
文字列。タイプに応じてノードの名前を返します。
1String XmlText.nodeValue;
オブジェクトが異なると、nodeName も異なる値を返します。
- XmlElement: ヌル
- XmlAttr: 属性値
- XmlText: ノードの内容
- XmlCDATASection: ノードの内容
- XmlProcessingInstruction: 指定されたコンテンツデータを返します
- XmlComment: 注釈テキスト
- XmlDocument: ヌル
- XmlDocumentType: ヌル
ownerDocument
XmlDocument、ノードのルート要素を返します (XmlDocument物体)
1readonly XmlDocument XmlText.ownerDocument;
parentNode
XmlNode、ノードの親ノードを返すことができます
1readonly XmlNode XmlText.parentNode;
childNodes
XmlNodeList、指定されたノードの子ノードのノードリストを返します。
1readonly XmlNodeList XmlText.childNodes;
children
XmlNodeListは、指定されたノードの子要素ノードのノード リストを返します。
1readonly XmlNodeList XmlText.children;
firstChild
XmlNode、ノードの最初の子ノードを返します。
1readonly XmlNode XmlText.firstChild;
lastChild
XmlNode、ノードの最後の子ノードを返します。
1readonly XmlNode XmlText.lastChild;
previousSibling
XmlNodeは、(同じツリー レベルで) ノードの直前のノードを返します。そのようなノードがない場合、このプロパティは null を返します。
1readonly XmlNode XmlText.previousSibling;
nextSibling
XmlNodeは、(同じツリー レベル内の) 要素の直後にあるノードを返します。そのようなノードがない場合、属性は null を返します。
1readonly XmlNode XmlText.nextSibling;
firstElementChild
XmlNode、ノードの最初の子要素ノードを返します。
1readonly XmlNode XmlText.firstElementChild;
lastElementChild
XmlNode、ノードの最後の子要素ノードを返します。
1readonly XmlNode XmlText.lastElementChild;
previousElementSibling
XmlNode, ノード (同じツリー レベル) の直前の要素ノードを返します。そのようなノードがない場合、このプロパティは null を返します。
1readonly XmlNode XmlText.previousElementSibling;
nextElementSibling
XmlNode, (同じツリー レベル内の) 要素の直後にある要素ノードを返します。そのようなノードがない場合、属性は null を返します。
1readonly XmlNode XmlText.nextElementSibling;
textContent
選択した要素のテキストをクエリおよび設定する文字列。クエリの場合は、要素ノード内のすべてのテキスト ノードの値を返します。設定の場合は、すべての子ノードを削除し、単一のテキスト ノードに置き換えます。
1String XmlText.textContent;
メンバー関数
splitText
指定されたオフセットに従ってテキスト ノードを 2 つのノードに分割します
1XmlText XmlText.splitText(Integer offset);
呼び出しパラメータ:
- offset: 整数。テキスト ノードを分割する場所を指定します。開始値は 0 から始まります
返される結果:
- XmlText, 現在のノードから分割されたテキスト ノード
このメソッドは、指定されたオフセットで XmlText ノードを 2 つのノードに分割します。元の XmlText ノードは、offset で指定された位置のテキスト コンテンツの前にテキスト コンテンツが含まれるように変更されます (ただし、テキスト コンテンツは含まれません)。新しい XmlText ノードが作成され、オフセット位置 (この位置の文字を含む) から元の文字の末尾までのすべての文字が格納されます。新しい XmlText ノードは、このメソッドの戻り値です。さらに、元の XmlText ノードにparentNode がある場合、新しい XmlText ノードは、元のノードの直後のこの親ノードに挿入されます。
XmlCDATASectionこのインターフェイスは XmlText インターフェイスを継承します。XmlCDATASectionノードでもこの方法を使用できますが、新しく作成されたノードはXmlCDATASectionXmlText ノードの代わりにノードを使用します。
substringData
ノードから部分文字列を抽出する
1
2String XmlText.substringData(Integer offset,
Integer count);
呼び出しパラメータ:
- offset: 整数、返される最初の文字の位置
- count: 整数、返される部分文字列の文字数
返される結果:
- String、抽出された文字列を返します
appendData
ノードに文字列を追加
1XmlText.appendData(String arg);
呼び出しパラメータ:
- arg: 文字列、ノードに追加される文字列
insertData
ノードに文字列を挿入
1
2XmlText.insertData(Integer offset,
String arg);
呼び出しパラメータ:
- offset: 整数、ノードに文字列が挿入される文字位置
- arg: String、挿入する文字列
deleteData
ノードからテキストを削除する
1
2XmlText.deleteData(Integer offset,
Integer count);
呼び出しパラメータ:
- offset: 整数、削除する最初の文字の位置
- count: 整数、削除する文字数
replaceData
ノードの文字を指定された文字列に置き換えます
1
2
3XmlText.replaceData(Integer offset,
Integer count,
String arg);
呼び出しパラメータ:
- offset: 整数、置換されるノードの文字位置
- count: 整数、置換する文字数
- arg: String、挿入する文字列
hasChildNodes
子ノードがあるかどうかを問い合わせる
1Boolean XmlText.hasChildNodes();
返される結果:
- Boolean、子ノードがある場合は true を返し、それ以外の場合は false を返します。
normalize
隣接するテキスト ノードをマージし、空のテキスト ノードを削除します
1XmlText.normalize();
このメソッドは、現在のノードのすべての子孫ノードを走査し、空の Text ノードを削除し、隣接するすべての Text ノードをマージすることでドキュメントを正規化します。この方法は、ノードの挿入または削除後にドキュメント ツリーの構造を簡素化するのに役立ちます。
cloneNode
指定されたノードの正確なコピーを作成します
1XmlNode XmlText.cloneNode(Boolean deep = true);
呼び出しパラメータ:
- deep: ブール値、ディープ コピーするかどうか。true の場合、複製されたノードは元のノードのすべての子ノードを複製します。
返される結果:
- XmlNode、コピーされたノードを返します
このメソッドは、呼び出されたノードのコピーをコピーして返します。渡された引数が true の場合、現在のノードのすべての子孫ノードも再帰的にコピーされます。それ以外の場合は、現在のノードをコピーするだけです。返されたノードはドキュメント ツリーに属しておらず、そのparentNode プロパティは null です。要素ノードがコピーされると、そのすべてのプロパティがコピーされます。
lookupPrefix
現在のノード上の指定された名前空間 URI に一致するプレフィックスを返します。
1String XmlText.lookupPrefix(String namespaceURI);
呼び出しパラメータ:
- namespaceURI: 文字列。一致する名前空間 URI を指定します。
返される結果:
- String、一致するプレフィックスを返し、一致しない場合は null を返します。
lookupNamespaceURI
現在のノード上の指定されたプレフィックスに一致する名前空間 URI を返します。
1String XmlText.lookupNamespaceURI(String prefix);
呼び出しパラメータ:
- prefix: 文字列、一致するプレフィックスを指定します
返される結果:
- String、一致する名前空間 URI を返し、一致しない場合は null を返します。
insertBefore
既存の子ノードの前に新しい子ノードを挿入します
1
2XmlNode XmlText.insertBefore(XmlNode newChild,
XmlNode refChild);
呼び出しパラメータ:
返される結果:
- XmlNode、新しい子ノードを返します
newChild がドキュメント ツリーに既に存在する場合は、ドキュメント ツリーから削除され、新しい位置に再挿入されます。1 つのドキュメントのノード (または 1 つのドキュメントによって作成されたノード) を別のドキュメントに挿入することはできません。つまり、newChild の ownerDocument 属性は、現在のノードの ownerDocument 属性と同じである必要があります。
insertAfter
既存の子ノードの後に新しい子ノードを挿入します
1
2XmlNode XmlText.insertAfter(XmlNode newChild,
XmlNode refChild);
呼び出しパラメータ:
返される結果:
- XmlNode、新しい子ノードを返します
newChild がドキュメント ツリーに既に存在する場合は、ドキュメント ツリーから削除され、新しい位置に再挿入されます。1 つのドキュメントのノード (または 1 つのドキュメントによって作成されたノード) を別のドキュメントに挿入することはできません。つまり、newChild の ownerDocument 属性は、現在のノードの ownerDocument 属性と同じである必要があります。
appendChild
新しい子ノードをノードの子ノード リストの末尾に追加します
1XmlNode XmlText.appendChild(XmlNode newChild);
呼び出しパラメータ:
- newChild:XmlNode、追加したノードを指定します
返される結果:
- XmlNode、この新しい子ノードを返します
newChild がドキュメント ツリーに既に存在する場合は、ドキュメント ツリーから削除され、新しい位置に再挿入されます。1 つのドキュメントのノード (または 1 つのドキュメントによって作成されたノード) を別のドキュメントに挿入することはできません。つまり、newChild の ownerDocument 属性は、現在のノードの ownerDocument 属性と同じである必要があります。
replaceChild
子ノードを別のノードに置き換える
1
2XmlNode XmlText.replaceChild(XmlNode newChild,
XmlNode oldChild);
呼び出しパラメータ:
返される結果:
- XmlNode, 置換が成功した場合、このメソッドは置換されたノードを返しますが、置換が失敗した場合は null を返します。
newChild がドキュメント ツリーに既に存在する場合は、ドキュメント ツリーから削除され、新しい位置に再挿入されます。1 つのドキュメントのノード (または 1 つのドキュメントによって作成されたノード) を別のドキュメントに挿入することはできません。つまり、newChild の ownerDocument 属性は、現在のノードの ownerDocument 属性と同じである必要があります。
removeChild
子ノードのリストからノードを削除します。
1XmlNode XmlText.removeChild(XmlNode oldChild);
呼び出しパラメータ:
- oldChild:XmlNode、削除するノードを指定します
返される結果:
- XmlNode, 削除が成功した場合、このメソッドは削除されたノードを返すことができますが、失敗した場合は null を返します。
toString
オブジェクトの文字列表現を返します。通常、「[Native Object]」が返されます。オブジェクトは、独自の特性に従って再実装できます。
1String XmlText.toString();
返される結果:
- String、オブジェクトの文字列表現を返します。
toJSON
オブジェクトの JSON 形式表現を返します。通常は、オブジェクトによって定義された読み取り可能なプロパティのコレクションを返します。
1Value XmlText.toJSON(String key = "");
呼び出しパラメータ:
- key: 文字列、使用されません
返される結果:
- Value、シリアル化可能な JSON を含む値を返します