Instance Method インスタンスメソッド

canonicalXMLStringPreservingComments:

Returns a string object encapsulating the receiver’s XML in canonical form. レシーバのもつXMLを正準形式においてカプセル化している文字列オブジェクトを返します。

Declaration 宣言 

- (NSString *)canonicalXMLStringPreservingComments:(BOOL)comments;

Parameters パラメータ

comments

YES to preserve comments, NO otherwise. YESをコメントを保全するために、そうでなければNO。

Discussion 議論

Be sure to set the input option NSXMLNodePreserveWhitespace for true canonical form. The canonical form of an XML document is defined by the World Wide Web Consortium at http://www.w3.org/TR/xml-c14n. Generally, if two documents with varying physical representations have the same canonical form, then they are considered logically equivalent within the given application context. The following list summarizes most key aspects of canonical form as defined by the W3C recommendation: 入力オプションNSXMLNodePreserveWhitespaceを実際通りの正準形式のために設定することを確実にしてください。XML書類の正準形式は、World Wide Web Consortiumによってhttp://www.w3.org/TR/xml-c14nで定義されます。一般に、実際の表現が異なっている２つの書類が同じ正準形式を持つならば、そのときそれらは、与えられたアプリケーション前後関係内で論理的に同等とみなされます。以下のリストは、W3Cによって定義されるように正準形式の大部分の鍵となる面を要約します：

  • Encodes the document in UTF-8. 書類をUTF-8において符号化します。

  • Normalizes line breaks to “#xA” on input before parsing. 入力ではラインブレークを “#xA” に正規化します、構文解析の前に。

  • Normalizes attribute values in the manner of a validating processor. 属性値を検証プロセッサの流儀で正規化します。

  • Replaces character and parsed entity references with their character content. 文字と構文解析されたエンティティ参照をそれらの文字内容で置き換えます。

  • Replaces CDATA sections with their character content. CDATAセクションをそれらの文字内容で置き換えます。

  • Removes the XML declaration and the document type declaration (DTD). XML宣言と書類型宣言（DTD）を取り除きます。

  • Converts empty elements to start-end tag pairs. 空要素を開始終了タグの対に変換します。

  • Normalizes whitespace outside of the document element and within start and end tags. 書類要素の外側と開始および終了タグ内部で空白を正規化します。

  • Retains all whitespace characters in content (excluding characters removed during line-feed normalization). 内容の中の全ての空白文字をそのままにします（ラインフィード正規化の間に取り除かれた文字を除いて）。

  • Sets attribute value delimiters to quotation marks (double quotes). 属性値区切りを引用符に設定します（二重引用符）。

  • Replaces special characters in attribute values and character content with character references. 属性値と文字内容の中の特殊文字を文字参照で置き換えます。

  • Removes superfluous namespace declarations from each element. 余分な名前空間宣言を各要素から取り除きます。

  • Adds default attributes to each element. 省略時の属性を各要素に加えます。

  • Imposes lexicographic order on the namespace declarations and attributes of each element. 語彙筆記的順序を名前空間宣言と各要素の属性に課します。

See Also 参照

Emitting Node Content ノード内容を発行する

XMLString
Returns the string representation of the receiver as it would appear in an XML document. レシーバの文字列表現を返します、それがXML書類において現れるのと同じに。
- XMLStringWithOptions:
Returns the string representation of the receiver as it would appear in an XML document, with one or more output options specified. レシーバの文字列表現を返します、それがXML書類において現れるのと同じに、１つ以上の指定された出力オプションで。
description
Returns a description of the receiver. レシーバのある記述を返します。