【iOS】Object-C注释

与其余语言同样，Object-C的注释也分为两种，一种是普通注释，一种是文档注释，普通注释一般给阅读代码的人看，而文档注释能够被appledoc识别，在使用的时候xcode能给出智能提示

 

简单注释
　　一、单行注释

　　　　单行注释不能被文档识别，一般用于函数内部

//学生信息

　　二、多行注释（这个也能够被识别）

/*
 *　多行注释内容
 */

 

文档注释（appledoc可识别成文档）

　　一、单行注释

@interface Student : NSObject ///名字
@property (nonatomic, copy) NSString *name; ///年龄
@property (nonatomic, assign) NSInteger age; ///校园卡Id
@property (nonatomic, copy) NSString *schoolId; ///年纪
@property (nonatomic, copy) NSString *grade; @end

　　　　若是安装了 VVDocument ，当输入///的时候回自动生成多行注释，一般咱们经过 /** 注释内容 */ 进行注释

@interface Student : NSObject /** 名字 */ @property (nonatomic, copy) NSString *name; /** 年龄 */ @property (nonatomic, assign) NSInteger age; /** 校园卡Id */ @property (nonatomic, copy) NSString *schoolId; /** 年纪 */ @property (nonatomic, copy) NSString *grade; @end

　　二、多行注释

/** 简要描述. * * 详细描述或其余. */

　　三、行尾注释

　　　　如上面的单行注释，当属性多了以后看起来会比较混乱，咱们也能够用下面的行尾注释，也能够被xcode识别

@interface Student : NSObject @property (nonatomic, copy) NSString *name;         /**< 名字 */ @property (nonatomic, assign) NSInteger age; /**< 年龄 */ @property (nonatomic, copy) NSString *schoolId;     /**< 校园卡Id */ @property (nonatomic, copy) NSString *grade;        /**< 年纪 */

@end 

 　　四、函数注释

　　　　函数注释也属于多行注释，一般咱们使用 VVDocument 插件辅助

/** * 获取状态描述 * * @param state 状态值 * * @return 返回状态描述 */
- (NSString *)getState:(NSInteger)state { switch (state) { case 1: return @"待确认"; break; case 2: return @"确认"; break; case 3: return @"驳回"; break; } }

 

　　在实际开发中，咱们应该多使用文档注释，使用文档注释能够得到xcode的智能提示，在用appledoc生成文档的时候也能够被识别

参考连接：http://www.cnblogs.com/zyl910/archive/2013/06/07/objcdoc.html