您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

NSXMLDocument 常用方法:elementsForName:、rootElement 與 stringValue

編輯:iOS 開發綜合

在做 DOM 式的 XML 解析時,最常翻到的就是 NSXMLDocument 這幾個方法。以下依官方文件的定義整理,並附上中文說明與實務提醒。

elementsForName:

定義:回傳接收者中,名稱符合指定條件的子元素節點,型別為 NSXMLElement 物件陣列。

- (NSArray *)elementsForName:(NSString *)name;

參數

name
要尋找並回傳的子元素節點名稱。若 name 是限定名稱(qualified name,即帶有 namespace prefix 的形式),這個方法會改為呼叫 elementsForLocalName:URI:,並把 URI 參數設為該 prefix 所對應的 URI。否則,比對方式就是限定或非限定名稱的字串相等比較。

回傳值

符合條件的 NSXMLElement 物件陣列;若找不到任何符合的子節點,則回傳空陣列(而非 nil)。

實務上要注意的是,這個方法只搜尋直接子節點,不會遞迴深入。若需要找出任意深度的後代節點,得自己遞迴呼叫,或改用 XPath(nodesForXPath:error:)。

rootElement

回傳文件的根元素。

- (NSXMLElement *)rootElement;

回傳值:接收者的根元素節點。

可用版本:OS X v10.4 及以後。

相關方法:– setRootElement:

宣告於:NSXMLDocument.h

這個方法是 DOM 解析的起點。典型的用法是取得根元素後,再往下層層呼叫 elementsForName: 逐步定位到目標節點。

stringValue

回傳註記(annotation)所關聯的字串。

- (NSString *)stringValue;

回傳值:該註記所設定的字串。

可用版本:OS X v10.4 及以後。

相關方法:– setStringValue:

宣告於:PDFAnnotationTextWidget.h

這裡有個容易混淆的點:stringValue 在 NSXMLNode 的體系中,指的是節點所承載的文字內容——也就是標籤之間那段文字。而在 PDFKit 的 PDFAnnotation 體系中,它指的是註記上的文字。兩者名稱相同但語境不同,查文件時要留意所屬的 framework。

一個完整的定位範例

NSXMLElement *root = [document rootElement];
NSArray *items = [root elementsForName:@"item"];

for (NSXMLElement *item in items) {
    NSString *title = [[item elementsForName:@"title"][0] stringValue];
    NSString *link  = [[item elementsForName:@"link"][0]  stringValue];
    NSLog(@"%@ - %@", title, link);
}

使用時建議先檢查陣列是否為空再取 [0],否則遇到結構不完整的 XML 就會 crash。另外,stringValue 取到的文字可能含有大量換行與縮排空白,記得用 stringByTrimmingCharactersInSet: 清理乾淨再做後續處理。

相關參考範例程式碼

  • Quartz Composer MiniSOAP
  • SimpleScriptingPlugin
  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved