SFXXMLCDATASection

[XML] CDATASection ノードを表すクラスです。

#include <SFXXMLCDATASection.hpp>

class SFXXMLCDATASection : public SFXXMLText;

SFMTYPEDEFCLASS(SFXXMLCDATASection)

継承図

協調図

解説

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

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

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

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

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

	注意
	`SFXXMLCDATASection` は `SFXXMLText` を継承します。

参照

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 ノードのいずれかを指定することが可能です。

	注意
	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 引数に返します。

	注意
	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);

戻り値

親ノード

解説

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

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

参照

SFXXMLNode::GetParentNode | SFXXMLNode

SFXXMLCDATASection::SplitText

2 つのノードに分割します。

[ public ]
SFXXMLTextPtr SplitText(
    SInt32 offset   // 分割位置
);

戻り値

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

解説

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

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

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

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

注意

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

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

参照

SFXXMLText::SplitText | SFXXMLText