iOS懒人开发：自动去除字典空值对象,仿系统字典创建方法NSDictionaryOfVariableBindings

说明

模仿系统的快速生成字典的方法NSDictionaryOfVariableBindings并过滤掉值为nil的对象或内容全为空格字符串。

推荐适用场合：网络请求生成参数字典，无需判空。<BR>
其他创建字典的地方也可以使用，注意此方法会过滤掉全为空格及@""字符串，如不需要可自行修改。

使用

    NSString *testStr = @"test";
    NSString *nilStr = nil;
    NSString *blankStr = @"   ";
    NSNumber *integerNumber = @124;
    NSNumber *NONumber = @(NO);
    NSNumber *zeroNumer = @0;
    People *peo = [[People alloc] init];
    People *peo_nil = nil;
    NSArray *array = @[];
    NSDictionary *dic = @{};
    
    NSDictionary *param = ZXDictionaryOfVariableBindings(testStr, nil, nilStr, blankStr, integerNumber, NONumber,zeroNumer, peo, peo_nil, array, dic);

param值：

{
    NONumber = 0;
    array =     (
    );
    dic =     {
    };
    integerNumber = 124;
    peo = "<People: 0x1c0452510>";
    testStr = test;
    zeroNumer = 0;
}

可以看到传入的参数可为nil不会崩溃，且生成字典后自动去除了值为nil和全是空格的NSString。

源码

//.h
#define ZXDictionaryOfVariableBindings(...) [Tool _ZXDictionaryOfVariableBindings:@"" # __VA_ARGS__, __VA_ARGS__]

/**
 模仿系统的对象生成字典的宏定义：NSDictionaryOfVariableBindings(...)
 if v1 = @"something"; v2 = nil; v3 = @"something"; v4 = @"";
 ZXDictionaryOfVariableBindings(v1, v2, v3) is equivalent to [NSDictionary dictionaryWithObjectsAndKeys:v1, @"v1", v3, @"v3", nil];
 并且参数的值可为nil,@"", 会自动去除值为nil, @"", @"  "等的对象
 */
+ (NSDictionary *)_ZXDictionaryOfVariableBindings:(NSString *)firstArg, ...;


//.m
+ (NSDictionary *)_ZXDictionaryOfVariableBindings:(NSString *)firstArg, ... {
    firstArg = [firstArg stringByReplacingOccurrencesOfString:@" " withString:@""];
    NSArray *keys = [firstArg componentsSeparatedByString:@","];
    NSMutableDictionary *dic = [NSMutableDictionary dictionaryWithCapacity:keys.count];
    va_list list;
    if (firstArg) {
        va_start(list, firstArg);
        id arg;
        for (NSString *key in keys) {
            arg = va_arg(list, id);
            if (!arg || [arg isKindOfClass:[NSNull class]]) {
                continue;
            }
            if ([arg isKindOfClass:[NSString class]]) {
                if ([[arg stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceAndNewlineCharacterSet]] length] != 0) {
                    [dic setObject:arg forKey:key];
                }
            } else {
                [dic setObject:arg forKey:key];
            }
        }
        va_end(list);
    }
    return dic;
}

原理

废话可不看↓

在开发经常需要创建字典对象，但是创建字典时存入的对象值不能为nil，否则会崩溃。

尤其是在进行网络请求时，更是经常需要对存入字典的对象判空，于是作为一个能少写一行代码绝不多写一个字母的懒癌晚期患者，就想要是创建字典时能自动对传入的对象判空并去除空值对象多好。

于是我就研究了系统的字典快捷创建方法NSDictionaryOfVariableBindings(...)，发现要解决此需求需要了解宏定义的使用，可变参数的使用。

宏定义

NSDictionaryOfVariableBindings初始化字典

创建字典的方法大家都比较熟悉，这里就不再说。

但是有一个根据对象名称创建字典的方法很方便，这里要说一下：

#define NSDictionaryOfVariableBindings(...) _NSDictionaryOfVariableBindings(@"" # __VA_ARGS__, __VA_ARGS__, nil)

这个方法是使用Autolayout时经常使用的一个宏，这个宏可以生成一个变量名到变量值映射的Dictionary。具体使用很简单，不再细说，不知道的同学推荐你们可以使用此方法创建字典，很方便。

使用此宏依旧需要对字典中的对象判空，防止传入空值崩溃，要想自动去除值为nil的对象，要参数传入之后入手，下面就来改造此宏定义自动去除传入的空值。

宏定义中的参数含义

要想改造系统创建字典的方法，首先要知道系统创建字典的原理。

#define NSDictionaryOfVariableBindings(...) _NSDictionaryOfVariableBindings(@"" # __VA_ARGS__, __VA_ARGS__, nil)中有3个参数,下面先搞清楚这三个参数的含义，也就知道了该方法的原理。

@"" # __VA_ARGS__中间#的作用：单个井号的作用是字符串化，将后面的宏参数 用双引号引起来，转为一个C字符串。如：

define GET_NAME(X) #X
int a = 0; 
NSLog(@”%s”,GET_NAME(a)); //output: “a” 
NSLog(@”%s”,GET_NAME(a+3)); //output: “a+3” 
将会得到以下输出：
a 
a+3

可以看出#，将参数原样转换成字符串常量，如果参数是一个表达式，那么输出这个表达式的原样字符串常量。

前面的@是objc的编译符号，不属于宏操作的对象。如果有宏定义@#expression,出来后就是一个内容是expression的内容的NSString。

__VA_ARGS__表示的是宏定义中的...中的所有参数。可变参数将被统一处理，在这里展开的时候编译器会将__VA_ARGS__直接替换为输入中的所有参数。

回头再看看NSDictionaryOfVariableBindings的定义：

#define NSDictionaryOfVariableBindings(...) _NSDictionaryOfVariableBindings(@"" # __VA_ARGS__, __VA_ARGS__, nil)

如果这样生成两个button的映射：

NSDictionaryOfVariableBindings(button1, button2);

那么预编译时就会转换成：

_NSDictionaryOfVariableBindings(@"" "button1, button2", button1, button2, nil);

由于两个常量字符串放在一起就是字符串常量串联，将变成两个字符串常量组合在一起的字符串常量，也就是上面是一个空字符串@""和"button1, button2"串联，所以上面的代码等价于：

_NSDictionaryOfVariableBindings(@"button1, button2", button1, button2, nil);

那么_NSDictionaryOfVariableBindings函数就可以将它的第一个参数按逗号，分割开作为key，后面就是各个key对应的值了。因此这段代码就创建了一个内容为{ @"button1" = button1, @"button2" = button2 }的Dictionary。

可变参数

再回看宏定义NSDictionaryOfVariableBindings(...),其中...即可变参数，其实可变参数并不少见，比如：

// 日志输出
NSLog(NSString *format, ...);
// NSString实例的创建
+(instancetype)stringWithFormat:(NSString *)format, ...;
// NSArray实例的创建
+(instancetype)arrayWithObjects:(ObjectType)firstObj, ... NS_REQUIRES_NIL_TERMINATION;

可变参数解析也很简单，直接拿封装的源码举例，注释写的很清楚了：

//.m
+ (NSDictionary *)_ZXDictionaryOfVariableBindings:(NSString *)firstArg, ... {
    // 取出第一个参数
    firstArg = [firstArg stringByReplacingOccurrencesOfString:@" " withString:@""];// 去除空格
    NSArray *keys = [firstArg componentsSeparatedByString:@","];
    NSMutableDictionary *dic = [NSMutableDictionary dictionaryWithCapacity:keys.count];
    // 定义一个指向个数可变的参数列表指针
    va_list list;
    if (firstArg) {
        // 初始化变量刚定义的va_list变量，这个宏的第二个参数是第一个可变参数的前一个参数，是一个固定的参数
        va_start(list, firstArg);
        // 用于存放取出的参数,C语言的字符指针, 指针根据offset来指向需要的参数,从而读取参数
        id arg;
        for (NSString *key in keys) {
            // 遍历全部参数 va_arg返回可变的参数(va_arg的第二个参数是你要返回的参数的类型)
            arg = va_arg(list, id);
            if (!arg || [arg isKindOfClass:[NSNull class]]) {
                continue;
            }
            if ([arg isKindOfClass:[NSString class]]) {
                if ([[arg stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceAndNewlineCharacterSet]] length] != 0) {
                    [dic setObject:arg forKey:key];
                }
            } else {
                [dic setObject:arg forKey:key];
            }
        }
        // 清空参数列表，并置参数指针args无效
        va_end(list);
    }
    return dic;
}

其中重点是不像其他字典初始化方法以nil作为传参结束判断的标准。

  • 以nil作为传参结束的变参方法：需要在定义方法时标识NS_REQUIRES_NIL_TERMINATION，则初始化时未尾一定要加上nil，如：
+ (instancetype)arrayWithObjects:(id)firstObj, ... NS_REQUIRES_NIL_TERMINATION;

因为这样的方法中没有提供对参数个数的检测，需要判断参数为nil时结束遍历，销毁指针偏移量，否则会崩溃。

  • 另外还有不以nil作为结束的变参方法，如NSLog：
FOUNDATION_EXPORT void NSLog(NSString *format, ...) NS_FORMAT_FUNCTION(1,2);
//注意后方的宏定义:NS_FORMAT_FUNCTION(1,2)，我们点击过去之后查看一下
#define NS_FORMAT_FUNCTION(F,A) __attribute__((format(__NSString__, F, A)))

看一下这句代码

__attribute__((format(__NSString__,F, A)))

这句的意思是，参数的第F位是格式化字符串，从A位开始我们开始检查

所以NSLog的第一个参数是一个格式化字符串，通过这个字条串就能获得后面的参数个数，而且能检查参数数量错误。

所以本文创建字典的方法的重点就是用已知个数的可变参数，去除为nil值的对象。

参考链接

觉得好用的点个赞❤~

©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 206,126评论 6赞 481
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 88,254评论 2赞 382
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 152,445评论 0赞 341
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 55,185评论 1赞 278
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 64,178评论 5赞 371
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 48,970评论 1赞 284
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 38,276评论 3赞 399
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 36,927评论 0赞 259
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 43,400评论 1赞 300
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,883评论 2赞 323
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,997评论 1赞 333
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,646评论 4赞 322
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 39,213评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,204评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,423评论 1赞 260
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 45,423评论 2赞 352
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,722评论 2赞 345