前のページ次のページ上に戻るホーム SophiaFramework UNIVERSE 5.3
SFXXMLCDATASection
[XML] CDATASection ノードを表すクラスです。
#include <SFXXMLCDATASection.hpp>
class SFXXMLCDATASection : public SFXXMLText;
SFMTYPEDEFCLASS(SFXXMLCDATASection)

継承図

SFXXMLCDATASection クラスの継承図

協調図

SFXXMLCDATASection クラスの協調図

解説

CDATASection ノード(SFXXMLCDATASection)は、 XML 文書の CDATA セクションの内容を保持します。

CDATA セクションでは、 "<"、">"、"&"、"""、"'" の文字をエンティティ参照や文字参照せずにそのまま使えます。

CDATA セクションは "]]>" の文字列で終了します。

CDATA セクションは入れ子にできません。

[Caution] 注意

内容の一部に文字列「]]>」が含まれる CDATA セクションは不正です。

[Note] 注意

SFXXMLCDATASectionSFXXMLText を継承します。

参照

SFXXMLNode | SFXXMLText | SFXXMLDocument

メンバ

コンストラクタ/デストラクタ
SFXXMLCDATASection( SFXXMLDocumentPtr owner , SFXAnsiStringConstRef name )
SFXXMLCDATASection クラスのコンストラクタです。
SFXXMLCDATASection( SFXXMLCDATASectionConstRef other , Bool deep = false )
SFXXMLCDATASection クラスのコンストラクタです。
~SFXXMLCDATASection( Void )
SFXXMLCDATASection クラスのデストラクタです。
パブリック関数
SFCError CloneNode( SFXXMLNodeHandle clonenode , Bool deep )
ノードのコピーを作成します。
DOMNodeListPtr GetChildNodes( Void )
【廃止予定】すべての子ノードを取得します。
ACharConstPtr GetNodeName( Void )
ノードの名前(nodeName 属性値)を取得します。
NodeType GetNodeType( Void )
ノードタイプ(nodeType 属性値)を取得します。
SFXXMLNodePtr GetParentNode( Void )
親ノードを取得します。
SFXXMLTextPtr SplitText( SInt32 offset )
2 つのノードに分割します。
SFCError AppendChild( SFXXMLNodeConstPtr newchild ) (SFXXMLNode から継承)
【無効】子ノードの最後にノードを追加します。
Void AppendData( ACharConstPtr data ) (SFXXMLText から継承)
テキストをノードの値(nodeValue 属性値)の末尾に追加します。
Void DeleteData( SInt32 offset , SInt32 count ) (SFXXMLText から継承)
ノードの値(nodeValue 属性値)を一部削除します。
Bool EqualNode( SFXXMLNodeConstPtr arg ) (SFXXMLNode から継承)
指定されたノードと同等かどうかを判定します。
ACharConstPtr GetData( Void ) (SFXXMLText から継承)
ノードの値(nodeValue 属性値)を取得します。
SFXXMLNodePtr GetFirstChild( Void ) (SFXXMLNode から継承)
【無効】最初の子ノードを取得します。
SFXXMLNodePtr GetLastChild( Void ) (SFXXMLNode から継承)
【無効】最後の子ノードを取得します。
SInt32 GetLength( Void ) (SFXXMLText から継承)
テキストの長さ(文字数)を取得します。
SFXXMLNodePtr GetNextSibling( Void ) (SFXXMLText から継承)
次の兄弟ノードを取得します。
ACharConstPtr GetNodeValue( Void ) (SFXXMLText から継承)
ノードの値(nodeValue 属性値)を取得します。
SFXXMLNodePtr GetPreviousSibling( Void ) (SFXXMLText から継承)
前の兄弟ノードを取得します。
SFXAnsiString GetText( Void ) (SFXXMLNode から継承)
ノードテキストを取得します。
Bool HasChildNodes( Void ) (SFXXMLNode から継承)
【無効】子ノードを持つかどうかを判定します。
SFCError InsertBefore( SFXXMLNodeConstPtr newchild , SFXXMLNodeConstPtr refchild ) (SFXXMLNode から継承)
【無効】ノードを挿入します。
Void InsertData( SInt32 offset , ACharConstPtr data ) (SFXXMLText から継承)
テキストを挿入します。
Bool IsSameNode( SFXXMLNodeConstPtr other ) (SFXXMLNode から継承)
指定されたノードと同一であるか判定します。
SFCError RemoveChild( SFXXMLNodeConstPtr oldchild ) (SFXXMLNode から継承)
【無効】子孫ノードも含めて子ノードを削除します。
SFCError ReplaceChild( SFXXMLNodeConstPtr newchild , SFXXMLNodeConstPtr oldchild ) (SFXXMLNode から継承)
【無効】子ノードを置換します。
Void ReplaceData( SInt32 offset , SInt32 count , ACharConstPtr data ) (SFXXMLText から継承)
テキストを置換します。
Void SetData( ACharConstPtr data ) (SFXXMLText から継承)
ノードの値(nodeValue 属性値)を設定します。
Void SetNodeValue( ACharConstPtr value ) (SFXXMLText から継承)
ノードの値(nodeValue 属性値)を設定します。
SFCError SetText( SFXAnsiStringConstRef text ) (SFXXMLNode から継承)
ノードテキストを設定します。
SFXAnsiString SubstringData( SInt32 offset , SInt32 count ) (SFXXMLText から継承)
部分文字列を取得します。
DOMNamedNodeMap (SFXXMLNode から継承)
複数の DOM ノードを名前またはローカル名と名前空間 URI で管理するためのクラスです。
DOMNodeList (SFXXMLNode から継承)
複数の DOM ノードをリスト形式で管理するためのクラスです。
NodeType (SFXXMLNode から継承)
ノードタイプを表す定数です。

SFXXMLCDATASection::SFXXMLCDATASection
SFXXMLCDATASection クラスのコンストラクタです。
[ public, explicit ]
SFXXMLCDATASection(
    SFXXMLDocumentPtr owner      // ドキュメントツリーのルート
    SFXAnsiStringConstRef name   // CDATAセクションの内容
);
[ public, explicit ]
SFXXMLCDATASection(
    SFXXMLCDATASectionConstRef other   // CDATASection ノード
    Bool deep = false                  // 子ノードを再帰的にコピーするかどうか
);

解説

このコンストラクタは、指定された値をこのノードに設定します。

引数には、このノードを所有するドキュメントツリーのルート(SFXXMLDocument)と CDATAセクションの内容、 または別の CDATASection ノードのいずれかを指定することが可能です。

[Note] 注意

name 引数に指定される CDATAセクションの内容は、 SFXXMLText::GetNodeValue 関数で取得できる、このノードの nodeValue 属性として設定されます。

参照

SFXXMLText::GetNodeValue | SFXXMLDocument


SFXXMLCDATASection::~SFXXMLCDATASection
SFXXMLCDATASection クラスのデストラクタです。
[ public, virtual ]
virtual ~SFXXMLCDATASection(Void);

解説

このデストラクタは、何も行いません。


SFXXMLCDATASection::CloneNode
ノードのコピーを作成します。
[ public, virtual ]
SFCError CloneNode(
    SFXXMLNodeHandle clonenode   // コピー先のノード(Handle 型)
    Bool deep                    // 子ノードを再帰的にコピーするかどうか【無効】
);

引数

clonenode

コピー先ノードを指定します。

deep

この引数は無効です。

戻り値

  • 成功したとき: SFERR_NO_ERROR
  • 失敗したとき: SFERR_FAILED

解説

この関数は、このノードのコピーを作成し、clonenode 引数に返します。

[Note] 注意

CDATASection ノードは子ノードを持たないので、 deep 引数は無効です。true を指定しても、false を指定しても結果は同じです。

参照

SFXXMLCDATASection::SFXXMLCDATASection | SFXXMLNode::CloneNode | SFXXMLNode


SFXXMLCDATASection::GetChildNodes
【廃止予定】すべての子ノードを取得します。
[ public, virtual, const ]
DOMNodeListPtr GetChildNodes(Void);

参照

SFXXMLNode::DOMNodeList | SFXXMLNode::GetChildNodes | SFXXMLNode


SFXXMLCDATASection::GetNodeName
ノードの名前(nodeName 属性値)を取得します。
[ public, virtual, const ]
ACharConstPtr GetNodeName(Void);

戻り値

"#cdata-section"

解説

この関数は、このノードのタイプ(nodeType 属性値)を取得します。

CDATASection ノードの場合、nodeType 属性値は "#cdata-section" です。

参照

SFXXMLNode::GetNodeName | SFXXMLNode


SFXXMLCDATASection::GetNodeType
ノードタイプ(nodeType 属性値)を取得します。
[ public, virtual, const ]
NodeType GetNodeType(Void);

戻り値

SFXXMLNode::CDATA_SECTION_NODE

解説

この関数は、このノードのタイプ(nodeType 属性値)を取得します。

CDATASection ノードの場合、nodeType 属性値は SFXXMLNode::CDATA_SECTION_NODE です。

参照

SFXXMLNode::NodeType | SFXXMLNode::GetNodeType | SFXXMLNode


SFXXMLCDATASection::GetParentNode
親ノードを取得します。
[ public, virtual, const ]
SFXXMLNodePtr GetParentNode(Void);

戻り値

親ノード

解説

この関数は、このノードの親ノードを取得します。

[Note] 注意

親ノードが存在しない場合は null を返します。

参照

SFXXMLNode::GetParentNode | SFXXMLNode


SFXXMLCDATASection::SplitText
2 つのノードに分割します。
[ public ]
SFXXMLTextPtr SplitText(
    SInt32 offset   // 分割位置
);

戻り値

新たに作成された CDATASection ノード(作成されなかった場合は null)

解説

この関数は、この CDATASection ノードを 2 つに分割し、新たに作成された CDATASection ノードを返します。

具体的な処理内容は以下の通りです。、

  1. この CDATASection ノードの nodeValue 属性値である CDATA セクションの内容(文字列)の offset 引数に指定された位置以降の文字列を削除します。
  2. この CDATASection ノードと同じ親ノードを持つ CDATASection ノードを新たに作成し、 その nodeValue 属性値を削除した文字列に設定します。
  3. そして、新しく作成した CDATASection ノードを返します。
  4. ※ offset 引数に指定された位置がこの CDATASection ノードの nodeValue 属性値である CDATA セクションの内容(文字列)の末尾を超える場合は、 この CDATASection ノードは分割されず、この関数は null を返します。
[Note] 注意

offset 引数に指定される位置が分割前の CDATASection ノードの CDATA セクションの内容(文字列)の末尾である場合、 この関数が返す CDATASection ノードの CDATA セクションは空の文字列です。

offset 引数に指定される値が 0 である場合、 分割後、この CDATASection ノードの CDATA セクションの内容(文字列)は空の文字列になります。 この関数が返す CDATASection ノードの CDATA セクションは分割前にこの CDATASection ノードに設定されていた CDATA セクションの内容(文字列)になります。

参照

SFXXMLText::SplitText | SFXXMLText