第19条:使用清晰而协调的命名方式
2018-09-15 本文已影响4人
MrSYLong
OC因为语法结构使代码读起来和句子一样,看起来比较啰嗦,但好处是代码读起来像日常语言里的句子,准确描述开发者想做的事。
方法与变量使用“驼峰大小写命名法”:以小写字母开头,其后每个单词首字母大写。
类名也用驼峰命名法,不过首字母大写,而且前面通常还有三个前缀字母。
方法命名
1.如果方法的返回值是新创建的,那么方法名的首个词应是返回值类型,除非前面还有修饰语,例如localizedString。属性的存取方法不遵循这种命名方式,因为一般认为这些方法不会创建新的对象,即便有时返回内部对象的一份拷贝,我们也认为那相当于原有的对象。
2.应该把表示参数类型的名词放在参数前面。
3.如果方法要在当前对象上执行操作,那么就应该包含动词;若执行操作时还需要参数,就在动词后面加上一个或多个名词。
4.不要使用str这种简称,应该用string这样的全称。
5.Boolean属性应该加is前缀。如果某方法返回非属性的Boolean值,那么应该根据其功能,选用has或is前缀。
6.将get这个前缀留给那些借由“输出参数”来保留返回值的方法。
类与协议的命名
类与协议的名称应该加上前缀,以避免命名空间冲突,而且应该想给方法起名是那样把词句组织好,使其从左至右读起来较为通顺。
最重要的一点:命名方式应该协调一致。如果从其他框架继承子类,那么务必遵循器命名惯例。如,从UIView类继承子类,那么类名末尾必须是View。创建自定义委托协议,则其名称中应该包含委托发起方的名称,后面再跟上Delegate一词。