Cocoa 拾遗 —— NSScanner

第一次看到 NSScanner 的使用是在 JSONModel 的源码中的 -__inspectProperties 方法。NSScanner 实例通过扫描去解析 model 对象的 property 的 attributes （property 是合成实例变量的属性，attributes 指的是 property 的修饰符如 readonly, copy 等等决定的特性）。

NSScanner

对于给定的字符串， NSScanner 实例可以扫描字符串中你需要的字符并解析成数据（十进制、十六进制数字、字符串等等）。可以通过 +scannerWithString: 来创建。现在捡到一个 txt 文件：

Company: Apple Inc.
Stock: AAPL (NASDAQ)
Founded: April 1, 1976, Cupertino, California, United States
CEO: Tim Cook
Headquarters: Cupertino, California, United States
Founders: Steve Jobs, Ronald Wayne, Steve Wozniak

我们要将每一行冒号前后的键值对放到字典中：

int main (int argc, char *argv[]) {
    NSError *error = nil;
     NSString *strData = [NSString stringWithContentsOfFile:<#file path#> 
                                                    encoding:NSUTF8StringEncoding error:&error];        
    if (error) {
        NSLog(@"%@", error);
    }
    
    NSMutableDictionary *exportData = [NSMutableDictionary new];
    NSScanner *scanner = [NSScanner scannerWithString:strData];
    
    while (![scanner isAtEnd]) {
        NSString *key;
        NSString *value;
        
        // 从当前位置开始，一直扫描到与 @":" 相匹配的子字符串的位置，
        // 并将已经扫描过的字符串放入到变量 key 中。
        // 比如在 @"Company: Apple Inc." 中，从头扫描到':'的位置，
        // 此时 scanLocation 为7，key 为 @"Company"。
        [scanner scanUpToString:@":" intoString:&key];
        
        // 直接从当前位置开始与给定字符串比较，
        // 如果匹配则返回扫描结果（与给定字符串相同），位置移动到匹配字符串之后，
        // 这里的作用是“吃掉”那个冒号，
        // 用 scanner.scanLocation++ 代替更好。
        [scanner scanString:@":" intoString:nil];
        
        [scanner scanUpToString:@"\n" intoString:&value];
        [exportData setValue:value forKey:key];
    }
    NSLog(@"%@", exportData);
    return 0;
}

注意点

1. 扫描的过程是顺序的，但你可以通过 scanLocation 属性改变当前扫描的位置；
2. 扫描默认跳过空白字符和换行符，可以通过 charactersToBeSkipped 改变它；
3. 扫描十六进制数， 使用 -scanHexInt: 获得整数时，“0x”或“0X”这样的前缀是可有可无的。但使用 -scanHexFloat:获得浮点数时，要求必须要有“0x”或“0X”前缀;
4. 使用 [[scanner string] substringFromIndex:[scanner scanLocation]] 获得未扫描的字符串。