【iOS】Object-C注释

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

 

简单注释
　　1、单行注释

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

//学生信息

　　2、多行注释（这个也可以被识别）

/*
 *　多行注释内容
 */

 

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

　　1、单行注释

@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

　　2、多行注释

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

　　3、行尾注释

　　　　如上面的单行注释，当属性多了之后看起来会比较混乱，我们也可以用下面的行尾注释，也可以被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 

 　　4、函数注释

　　　　函数注释也属于多行注释，通常我们使用 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