字串處理是 iOS 開發的日常。以下把 NSString 最常用的方法依功能整理成速查表,方便隨時翻閱。
// 建立新字串,內容為 path 指定檔案,使用編碼 enc,錯誤回傳於 error
+ (id)stringWithContentsOfFile:(NSString *)path
encoding:(NSStringEncoding)enc
error:(NSError **)error;
// 建立新字串,內容為 url 指定的資源,使用編碼 enc,錯誤回傳於 error
+ (id)stringWithContentsOfURL:(NSURL *)url
encoding:(NSStringEncoding)enc
error:(NSError **)error;
// 建立新的空字串
+ (id)string;
// 建立新字串,內容等同 aString
+ (id)stringWithString:(NSString *)aString;
// 以 aString 的內容初始化
- (id)initWithString:(NSString *)aString;
// 以檔案內容初始化
- (id)initWithContentsOfFile:(NSString *)path
encoding:(NSStringEncoding)enc
error:(NSError **)error;
// 以 URL 內容初始化
- (id)initWithContentsOfURL:(NSURL *)url
encoding:(NSStringEncoding)enc
error:(NSError **)error;
// 回傳字串中的字元數目
- (NSUInteger)length;
// 回傳索引 index 處的 Unicode 字元
- (unichar)characterAtIndex:(NSUInteger)index;
注意 length 回傳的是 UTF-16 碼元數,並不等於使用者感知的「字數」。處理 emoji 或組合字元時,應搭配 rangeOfComposedCharacterSequencesForRange: 使用。
// 從 from 索引到結尾
- (NSString *)substringFromIndex:(NSUInteger)from;
// 從開頭到 to 索引
- (NSString *)substringToIndex:(NSUInteger)to;
// 依指定範圍擷取
- (NSString *)substringWithRange:(NSRange)range;
// 忽略大小寫比較
- (NSComparisonResult)caseInsensitiveCompare:(NSString *)string;
// 依地區規則比較
- (NSComparisonResult)localizedCompare:(NSString *)string;
// 是否以 aString 開頭
- (BOOL)hasPrefix:(NSString *)aString;
// 是否以 aString 結尾
- (BOOL)hasSuffix:(NSString *)aString;
// 兩字串是否完全相同
- (BOOL)isEqualToString:(NSString *)aString;
// 每個單詞首字母大寫,其餘小寫
- (NSString *)capitalizedString;
// 全部轉小寫
- (NSString *)lowercaseString;
// 全部轉大寫
- (NSString *)uppercaseString;
需要地區正確性的話,請改用 lowercaseStringWithLocale: 與 uppercaseStringWithLocale:,特別是處理土耳其語時。
// 轉為 UTF-8 格式的 C 字串
- (__strong const char *)UTF8String;
// 轉為各種數值型別
- (double)doubleValue;
- (float)floatValue;
- (int)intValue;
- (NSInteger)integerValue;
UTF8String 的生命週期。它回傳的 const char * 由 autorelease pool 管理,只在當前事件迴圈內有效。要長期保留請用 strdup 複製,或改用 -cStringUsingEncoding: 並自行管理緩衝區。
intValue 的寬鬆語意。它會解析前導數字並忽略其餘部分,@"123abc" 會得到 123,@"abc" 得到 0。要嚴格驗證請改用 NSScanner 或 NSNumberFormatter。
檔案讀取的錯誤處理。範例中的 stringWithContentsOfFile:encoding:error: 在檔案不存在時會回傳 nil,务必檢查。舊的 stringWithContentsOfFile: 已在 iOS 2.0 淘汰,不要再用。
路線建議。讀取使用者可見的文字時,stringWithContentsOfFile:usedEncoding:error: 能自動偵測編碼,比強制指定更穩健。而在 Swift 中,這些方法多已改為 String(contentsOf:encoding:) 的 throw 版本,錯誤處理更直觀。