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

nodesForXPath:error:

Returns the nodes resulting from executing an XPath query upon the receiver. XPathクエリをレシーバ上で遂行する結果としてのノードを返します。

Declaration 宣言 

- (NSArray<__kindof NSXMLNode *> *)nodesForXPath:(NSString *)xpath 
                                           error:(NSError * _Nullable *)error;

Parameters パラメータ

xpath

A string that expresses an XPath query. ある文字列、それはXPathクエリを表現します。

error

If query errors occur, indirectly returns an NSError object describing the errors. クエリエラーが発生するならば、エラーを記述しているNSErrorオブジェクトを間接的に返します。

Return Value 戻り値

An array of NSXMLNode objects that match the query, or an empty array if there are no matches. クエリに一致するNSXMLNodeオブジェクトそれらからなるある配列、または空の配列、もし一致するものがないならば。

Discussion 議論

The receiver acts as the context item for the query (“.”). If you have explicitly added adjacent text nodes as children of an element, you should invoke the NSXMLElement method normalizeAdjacentTextNodesPreservingCDATA: (with an argument of NO) on the element before applying any XPath queries to it; this method coalesces these text nodes. The same precaution applies if you have processed a document preserving CDATA sections and these sections are adjacent to text nodes. レシーバはクエリに対する前後関係項目として振る舞います（“.”）。あなたが明示的に近隣のテキストノードをある要素の子として加えたならば、あなたはNSXMLElementのメソッドnormalizeAdjacentTextNodesPreservingCDATA:を（NOの引数で）その要素上で発動すべきです、それに何らかのXPathクエリを適用する前にです；このメソッドはそれらテキストノードを結合します。あなたがCDATAセクションを保全するある書類を処理したそしてそれらセクションがテキストノードに隣り合うならば、同じ予防措置が当てはまります。

See Also 参照

Executing Queries クエリを遂行する

- objectsForXQuery:error:
Returns the objects resulting from executing an XQuery query upon the receiver. XQueryクエリをレシーバ上で遂行する結果としてのオブジェクトを返します。
- objectsForXQuery:constants:error:
Returns the objects resulting from executing an XQuery query upon the receiver. XQueryクエリをレシーバ上で遂行する結果としてのオブジェクトを返します。
XPath
Returns the XPath expression identifying the receiver’s location in the document tree. 書類ツリーにおいてレシーバのもつ位置を識別しているXPath表現を返します。