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

[譯] NSScanner:被忽略的字符串解析與條件判斷利器

編輯:iOS 開發基礎

本文為投稿文章,作者:Flying_Einstein(簡書),翻譯自 NSScanner 官方文檔。

NSScanner 是一個類簇的抽象父類,為「從 NSString 對象中掃描取值」提供了統一的程序接口。它能把字符串中的字符解析並轉換為 number 或 string 類型的值:創建時為它分配一個字符串,取值時它會從頭到尾逐個遍歷。

由於類簇的特性,scanner 對象並非 NSScanner 的實例,而是其某個私有子類的實例。儘管實際所屬類是私有的,但接口是公開的(由抽象父類聲明)。掃描字符串時,你可以通過 charactersToBeSkipped 屬性指定要忽略的字符,掃描前位於忽略集中的字符會被跳過,默認忽略空格與回車。若想得到尚未掃描的字符串,可用 [[scanner string] substringFromIndex:[scanner scanLocation]] 獲取。

創建 Scanner 對象

+ (instancetype)scannerWithString:(NSString *)aString
+ (id)localizedScannerWithString:(NSString *)aString
- (instancetype)initWithString:(NSString *)aString
  • scannerWithString:返回掃描 aString 的 NSScanner 對象,內部通過調用 initWithString 設置掃描字符串。
  • localizedScannerWithString:返回按用戶默認 locale 掃描字符串的 NSScanner 對象,同樣內部調用 initWithString。
  • initWithString:返回完成初始化的 NSScanner 對象。

獲取 Scanner 的字符串

@property(readonly, copy) NSString *string

配置 Scanner

@property NSUInteger scanLocation
@property BOOL caseSensitive
@property(copy) NSCharacterSet *charactersToBeSkipped
@property(retain) id locale
  • scanLocation:下次掃描的起始位置,若超出 string 范圍會拋出 NSRangeException;出錯後重新掃描時非常有用。
  • caseSensitive:是否區分大小寫,默認 NO,且不作用於被跳過的字符集。
  • charactersToBeSkipped:掃描時跳過的字符集,默認為空格與回車。跳過優先於掃描:例如跳過集為空格時,用 scanInt: 查找整數會先跳過空格,直到遇到十進制數據或其他字符;一旦被掃描,跳過即失效。若掃描字符與跳過字符相同,結果未定義。該字符集是唯一值,不套用忽略大小寫,也不做組合。若想掃描時忽略全部元音,就把它設為 "AEIOUaeiou"。
  • locale:影響 scanner 對數值的解析,它依據 locale 的十進制分隔符區分整數與小數部分。未設置 locale 的新 scanner 使用系統默認 locale。

掃描字符串

- (BOOL)scanCharactersFromSet:(NSCharacterSet *)scanSet intoString:(NSString * _Nullable *)stringValue;
- (BOOL)scanUpToCharactersFromSet:(NSCharacterSet *)stopSet intoString:(NSString * _Nullable *)stringValue;
- (BOOL)scanString:(NSString *)string intoString:(NSString * _Nullable *)stringValue;
- (BOOL)scanUpToString:(NSString *)stopString intoString:(NSString * _Nullable *)stringValue;
- (BOOL)scanDecimal:(NSDecimal *)decimalValue;
- (BOOL)scanDouble:(double *)doubleValue;
- (BOOL)scanFloat:(float *)floatValue;
- (BOOL)scanHexDouble:(double *)result;
- (BOOL)scanHexFloat:(float *)result;
- (BOOL)scanHexInt:(unsigned int *)intValue;
- (BOOL)scanHexLongLong:(unsigned long long *)result;
- (BOOL)scanInt:(int *)intValue;
- (BOOL)scanInteger:(NSInteger *)value;
- (BOOL)scanUnsignedLongLong:(unsigned long long *)unsignedLongLongValue;
@property(getter=isAtEnd, readonly) BOOL atEnd;
  • scanCharactersFromSet:intoString::逐個匹配 scanSet 中的字符。例如字符集為 @"test123Dmo"、掃描串為 @" 123test12Demotest",則整串字符都在集合內,指針存儲 "123test12Demotest"。
  • scanUpToCharactersFromSet:intoString::一直掃描到遇到 stopSet 中的字符為止,指針存儲遇到之前的部分。
  • scanString:intoString::從當前位置判斷能否掃到與傳入串相同的內容,能則返回 YES。例如 string 為 123abc678、傳入 abc,位置為 0 時掃不到,設為 3 則可以。
  • scanUpToString:intoString::掃描到與傳入串相同處停止,指針存儲之前的部分(上例存儲 123)。
  • scanDecimal::掃描 NSDecimal 類型值,詳見 NSDecimalNumber。
  • scanDouble::掃描雙精度浮點,溢出與非溢出都視為合法;溢出時會跳過所有數字,新位置落在整個浮點數之後,指針存儲掃描值(溢出時為 ±HUGE_VAL,否則為 0.0)。
  • scanFloat::掃描單精度浮點,規則同 scanDouble。
  • scanHexDouble::掃描雙精度十六進制,格式對應 %a 或 %A,十六進制前需加 0x 或 0X,溢出處理同上。
  • scanHexInt:掃描十六進制無符整型,溢出時為 UINT_MAX。
  • scanHexLongLong:規則同 scanHexDouble。
  • scanInt:掃描整型,溢出也視為有效,溢出時為 INT_MAX 或 INT_MIN。
  • scanInteger:規則同 scanInt。
  • scanLongLong:掃描 LongLong,溢出時為 LLONG_MAX 或 LLONG_MIN。

實例:輸入框只能輸入數字與小數點

下面封裝了一個方法,用於限制 UITextField 只能輸入數字與至多一位小數點,並可通過 number 參數指定小數位數,在 textField:shouldChangeCharactersInRange:replacementString: 代理方法中調用。

頭文件:

#import
@interface ConditionJudgmentController : NSObject
// 輸入框中只能輸入數字和小數點,且小數點只能輸入一位;參數 number 可設置小數位數
+ (BOOL)isValidAboutInputText:(UITextField *)textfield shouldChangeCharactersInRange:(NSRange)range replacementString:(NSString *)string decimalNumber:(NSInteger)number;
@end

實現:

#import "ConditionJudgmentController.h"
@implementation ConditionJudgmentController
+ (BOOL)isValidAboutInputText:(UITextField *)textField shouldChangeCharactersInRange:(NSRange)range replacementString:(NSString *)string decimalNumber:(NSInteger)number {
    NSScanner *scanner = [NSScanner scannerWithString:string];
    NSCharacterSet *numbers;
    NSRange pointRange = [textField.text rangeOfString:@"."];
    if ((pointRange.length > 0) && (pointRange.location < range.location || pointRange.location > range.location + range.length)) {
        numbers = [NSCharacterSet characterSetWithCharactersInString:@"0123456789"];
    } else {
        numbers = [NSCharacterSet characterSetWithCharactersInString:@"0123456789."];
    }
    if ([textField.text isEqualToString:@""] && [string isEqualToString:@"."]) {
        return NO;
    }
    short remain = number; // 保留 number 位小數
    NSString *tempStr = [textField.text stringByAppendingString:string];
    NSUInteger strlen = [tempStr length];
    if (pointRange.length > 0 && pointRange.location > 0) { // 判斷輸入框內是否含有「.」
        if ([string isEqualToString:@"."]) { // 已含「.」時再輸入「.」視為無效
            return NO;
        }
        if (strlen > 0 && (strlen - pointRange.location) > remain + 1) { // 超出保留位數視為無效
            return NO;
        }
    }
    NSRange zeroRange = [textField.text rangeOfString:@"0"];
    if (zeroRange.length == 1 && zeroRange.location == 0) { // 判斷首字符是否為「0」
        if (![string isEqualToString:@"0"] && ![string isEqualToString:@"."] && [textField.text length] == 1) {
            textField.text = string; // 只有一個「0」時,輸入非「0」「.」字符則替換
            return NO;
        } else {
            if (pointRange.length == 0 && pointRange.location > 0) {
                if ([string isEqualToString:@"0"]) { // 首位為「0」且無「.」時,再輸入「0」視為無效
                    return NO;
                }
            }
        }
    }
    NSString *buffer;
    if (![scanner scanCharactersFromSet:numbers intoString:buffer] && ([string length] != 0)) {
        return NO;
    } else {
        return YES;
    }
}
@end

注意:以上方法需配合 UITextField 的代理方法使用:

-(BOOL)textField:(UITextField *)textField shouldChangeCharactersInRange:(NSRange)range replacementString:(NSString *)string {
    return [ConditionJudgmentController isValidAboutInputText:textField shouldChangeCharactersInRange:range replacementString:string decimalNumber:3];
}

結束語

日常做條件判斷時,大家可能更習慣用正則表達式或 if 語句。其實 NSScanner 提供了一種更優雅的方式,將它與其他手段結合使用,往往能收穫更好的效果。

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