Xcode 文档注释方法

摘自:http://www.cnblogs.com/bomo/p/4815963.html

 

文档注释,可以在调用时显示注释信息,让调用者更好的理解方法的用途。

注释方法:

  • /// 注释 和 /** 注释 */  在调用时,Xcode可以显示注释信息,注意 "/**" 是两个"*", 一颗星注释时,不能显示提示。
  • 多行注释,提示时只能显示一行。
  • 在行尾注释 需要加"<" 符号,否则不会显示, 如:///< 注释 或 /**< 注释 */

下面几种方式都是可以的

@interface testClass : NSObject

/// property A is XXXX
@property (nonatomic) NSString *propertyA;
@property (nonatomic) NSString *propertyB; ///< property B is XXX;

/** property C is XXX */
@property (nonatomic) NSString *propertyC;
@property (nonatomic) NSString *propertyD; /**< property D is XXX */

/// this is a function ;
-(void) testFunA;

/** this is a function */
-(void) testFunB;

/**
 * this is a function 
 * param is a string
 * @param input  a string
 * @return  no return
 */
-(void) testFunC:(NSString *) input;
@end

@interface ASNavigationController : UINavigationController

@end

Xcode 文档注释方法_第1张图片

你可能感兴趣的:(Xcode 文档注释方法)