OC命名规范及代码注释规范

OC 命名规范及代码注释规范

    初级的开发者经常因变量过多,文件杂乱叫苦连天,其实计算机语言是人和计算机之间通信的媒介。好的代码应该是就像人对计算机说话那样,让人看起来轻松易懂,规范的命名和代码注释可以帮助咱们减小bug,较好的和同事进行代码交流。然而命名看似简单的事,不少有经验的程序员很难作到。在苹果的SDK中有大量的API,就有不少咱们值得效仿的例子,如begin,,did,subtitle,adjustsImageWhenDisabled,adjustsImageWhenHighlighted等,所以对于程序开发语言的学习,较好的英语功底有很大优点。程序员

 1.一些命名技巧  函数

程序中变量名尽可能用英文简称(禁止用拼音),如student简写为stu,button简写为btn。oop

定义对象动做的时候,若是即将发生用begin,正在进行用do,已经结束用did。学习

类命名的时候前面尽可能添加英文大写前缀,对象后面可能是英文名字添加后缀。优化

2.普通注释的写法.spa

经常使用的注释形势有单行注释("//")和多行注释("/**/"),若是在代码编写时只是简单地定义变量或者简单声明类和对象的时候可用单行注释,若是注释内容较多,则换取多行。代理

3.类或对象(协议、分类)的注释code

//声明父类
@inertface person:NSObject

/*声明子类
* 继承自person
*/
@interface children :person

4.一些封装好的函数或者代码块的注释对象

/**
*打印hello world
**/
-(void)print
{
  NSLog(@"hello world");
}
/**打印输出helloworld
*    含三个字符串参数
*/
#import <Foundation/Foundation.h>

int main(int argc, const char * argv[]) {
    @autoreleasepool {
        NSString *str1=@"hello";
        NSString*str2=@"world";
        NSString*str3=[str1 stringByAppendingString:str2];
        NSLog(@"%@",str3);
    }
    return 0;
}

5.代理方法和数据源注释方法blog

      #pragma  mark 用来注释代理方法和数据源注释方法,#pragma是一个预处理指令,用来设定编译器的状态或者指示编译器完成一些特定的动做,#pragma相应的还有#pragma once(保证头文件被编译一次),#pragma hdrstop (表示预编译的头文件到此结束编译),#pragma comment (该指令将一个注释记录放入一个对像文件或可执行文件中。

经常使用的lib关键字,能够帮咱们连入一个库文件。
每一个编译程序能够用#pragma指令激活或终止该编译程序支持的一些编译功能。例如,对循环优化功能:
1 #pragma loop_opt(on)//开始激活
2 #pragma loop_opt(off)//终止激活

在c语言编写时,程序中会有些函数会使编译器发出你熟知而想忽略的警告,如“Parameter xxx is never used in function xxx”,能够这样:

#pragma warn—100//Turnoffthewarningmessageforwarning#100
intinsert_record(REC*r)
{/*functionbody*/}
#pragma warn+100//Turnthewarningmessageforwarning#100backon

函数会产生一条有惟一特征码100的警告信息,如此可暂时终止该警告

相似 #pragma预编译方法还有不少,就不列举了。

相关文章
相关标签/搜索