NSCharacterSet 是 Foundation 框架中代表「Unicode 字元集合」的類別,繼承自 NSObject,遵循 NSCoding、NSCopying 與 NSMutableCopying,自 iOS 2.0 起即已提供,宣告於 NSCharacterSet.h。
NSCharacterSet 物件用來表示一組符合 Unicode 規範的字元。NSString 與 NSScanner 會借助它把字元分門別類,以便在搜尋時一次比對出「屬於某一類」的所有字元。
這個類別簇(class cluster)有兩個公開類別:NSCharacterSet 與 NSMutableCharacterSet,分別宣告靜態與動態字元集合的程式介面。透過它們建立的物件稱為字元集合物件。由於類別簇的特性,這些物件其實並不是 NSCharacterSet 或 NSMutableCharacterSet 的真正實例,而是其某個私有子類別的實例;雖然類別是私有的,介面卻是公開的,由這兩個抽象父類別宣告。兩個類別都採用了 NSCopying 與 NSMutableCopying 協議,因此在不可變與可變型別之間轉換相當方便。
NSCharacterSet 最主要的原始方法是 characterIsMember:,介面中所有其他實例方法都以它為基礎。若要自訂子類別,只需實作這個方法加上 mutableCopyWithZone: 即可正確運作;若追求效能,還應覆寫 bitmapRepresentation,否則預設實作會針對每一個可能的 Unicode 值呼叫 characterIsMember:,代價相當高。
此外,NSCharacterSet 與 Core Foundation 的 CFCharacterSetRef 之間是「toll-free bridged」,兩者可以互相直接轉換。它的可變子類別是 NSMutableCharacterSet。
類別方法一行就能取得常用的預設集合:
做 URL 相關處理時,這組方法非常好用:
characterSetWithCharactersInString::由字串中的字元組成集合。characterSetWithRange::由一段 Unicode 範圍組成集合。invertedSet:取反集,得到「不在原本集合中」的所有字元,實務上非常常用。characterSetWithBitmapRepresentation::由 NSData 點陣還原集合。characterSetWithContentsOfFile::從檔案讀入點陣資料。bitmapRepresentation:把集合轉為 NSData 點陣,便於存檔或跨程序傳遞。characterIsMember::判斷單一 UTF-16 字元是否屬於集合,是整個類別的基礎方法。longCharacterIsMember::判斷 UTF-32 字元,用於處理超出基本多文語言平面的字元(如部分 emoji 與罕用字)。hasMemberInPlane::判斷指定 Unicode 平面(plane)中是否有成員。isSupersetOfSet::判斷是否為另一個集合的超集。最常見的組合是搭配 NSString 的 rangeOfCharacterFromSet:,用來找出字串中第一個符合條件的字元位置。例如過濾輸入或驗證格式:
NSCharacterSet *digits = [NSCharacterSet decimalDigitCharacterSet];
NSRange range = [input rangeOfCharacterFromSet:[digits invertedSet]];
if (range.location != NSNotFound) {
NSLog(@"輸入含有非數字字元");
}
由於 NSCharacterSet 是不可變的,需要動態增減成員時請改用 NSMutableCharacterSet 的 addCharactersInString:、addCharactersInRange:、removeCharactersInString: 等方法。
(本文整理自 Apple 官方類別參考,Apple Inc. 版權所有。)