本章基本概括

一，什么是注释，为什么要做注释

• 什么是注释
• 为什么要做注释
• 温馨提示：
1.初学者编写程序应该养成习惯:先写注释再写代码或写完代码后立即写注释以防过后忘记
2.可以将自己的步骤先通过注释整理出来，然后再用代码去体现
3.代码是工具上的实现，注释是思考的一中表现

二，注释的目的与应用场景

• 常见用法一（解释代码）：

- (UIBarButtonItem *)initWithNorImage:(NSString *)norimage higImage:(NSString *)higImage title:(NSString *)title target:(id)target action:(SEL)action
{
    // 1.创建一个按钮
    UIButton *btn = [[UIButton alloc] init];
    // 2.设置按钮的默认图片和高亮图片
    if (norimage != nil &&
        ![norimage isEqualToString:@""]) {
        // 图片不为空
        [btn setImage:[UIImage imageNamed:norimage] forState:UIControlStateNormal];
    }
    if (higImage != nil &&
        ![higImage isEqualToString:@""]) {
        // 图片不为空
        [btn setImage:[UIImage imageNamed:higImage] forState:UIControlStateHighlighted];
    }
    // 设置标题
    [btn setTitle:title forState:UIControlStateNormal];

    // 3.监听按钮的点击事件
    [btn addTarget:target action:action forControlEvents:UIControlEventTouchUpInside];
    // 4.设置按钮的frame
    // 可以调用控件的sizeToFit方法来自动调整控件的大小
    [btn sizeToFit];

    // 5.根据按钮创建BarButtonItem
    return [[UIBarButtonItem alloc] initWithCustomView:btn];
}

• 常见用法二（做函数说明）：

/**
 *  创建item
 *
 *  @param norimage 默认状态的图片
 *  @param higImage 高亮状态的图片
 *  @param title    标题
 *
 *  @return 创建好的item
 */
- (UIBarButtonItem *)initWithNorImage:(NSString *)norimage higImage:(NSString *)higImage title:(NSString *)title target:(id)target action:(SEL)action
{
    // 1.创建一个按钮
    UIButton *btn = [[UIButton alloc] init];
    // 2.设置按钮的默认图片和高亮图片
    if (norimage != nil &&
        ![norimage isEqualToString:@""]) {
        // 图片不为空
        [btn setImage:[UIImage imageNamed:norimage] forState:UIControlStateNormal];
    }
    if (higImage != nil &&
        ![higImage isEqualToString:@""]) {
        // 图片不为空
        [btn setImage:[UIImage imageNamed:higImage] forState:UIControlStateHighlighted];
    }
    // 设置标题
    [btn setTitle:title forState:UIControlStateNormal];

    // 3.监听按钮的点击事件
    [btn addTarget:target action:action forControlEvents:UIControlEventTouchUpInside];
    // 4.设置按钮的frame
    // 可以调用控件的sizeToFit方法来自动调整控件的大小
    [btn sizeToFit];

    // 5.根据按钮创建BarButtonItem
    return [[UIBarButtonItem alloc] initWithCustomView:btn];
}

• 常见用法三（做思路分析）：

以登录为例:
   * 获取用户的输入信息.
   * 判断输入的信息是否合乎规则.
   * 登录密码加密.
   * 把加密后的数据作为参数请求接口.

三，注释的特点

四，单行注释和多行注释

• 单行注释：
• 多行注释：

五，使用注释应该注意哪些

• 1.单行注释可以嵌套单行注释、多行注释

// ios // 三年
 // /* 三年 */
 // iOS三年

• 2.多行注释可以嵌套单行注释

/*
// 作者:iOS三年
// 描述:复习很简单，就看你看不看“三年”
*/

• 3.多行注释时不能嵌套多行注释(错误写法)

/*  你好
   /* ios */
   三年 */