
本文為投稿文章,作者: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
獲取 Scanner 的字符串
@property(readonly, copy) NSString *string
配置 Scanner
@property NSUInteger scanLocation @property BOOL caseSensitive @property(copy) NSCharacterSet *charactersToBeSkipped @property(retain) id 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;
實例:輸入框只能輸入數字與小數點
下面封裝了一個方法,用於限制 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 提供了一種更優雅的方式,將它與其他手段結合使用,往往能收穫更好的效果。