• 山西税务系统一次性“打包”12项业务 2019-10-13
  • 江干区结对帮扶西藏那曲教育玩转“一对一”“多对一” 2019-10-11
  • 6月15日一分钟阅尽天下军情 2019-10-11
  • 赌王四太家的豪宅曝光,网友:一点都不羡慕 ——凤凰网房产 2019-10-10
  • 郭碧婷曝杨幂怀孕趣事,杨幂实力学习台湾腔 2019-10-10
  • 川航成功备降获赞还需反思 提直降代倒逼OTA服务提升 2019-10-10
  • 旅游--北京频道--人民网 2019-09-19
  • 山东将推动各类保护区范围内煤矿有序退出 2019-09-19
  • 史上最大锦鲤!南京大二女生一次收到618个快递 2019-09-14
  • 俄罗斯球队为国争光,为普京争脸。揭幕战横扫沙特队,吸引世界眼球。一代伟人普京,是俄罗斯人民的福气,强国,强军、富民,是普京献词“地球盛宴”的真正荣耀时刻,俄国人 2019-09-14
  • 海军第27批护航编队结束对摩洛哥访问  2019-09-05
  • 【脱贫路上】衣比·衣明: 小庭院里巧增收 2019-09-05
  • 华媒:瑞士失业率创历史新低 技术型劳动力短缺 2019-09-04
  • 告别“电钻音”安静“不扰民” 九阳率先推出静音破壁机 2019-09-01
  • 《歌手》首发阵容6年来最尬?令我震惊的只有…… 2019-08-23
  • 六合图库财神 >iOS开发

    iOS 注释方法大全 代码块加快捷键注释

    2019-03-11 17:04 编辑: 米米狗 分类:iOS开发 来源:_小迷糊

    注释规范

    良好的编码规范是程序员必备的素质,编码中的代码注释尤为重要,健全的代码注释可以提高代码可读性和维护性,不仅为了标识此块代码的含义,很多时候包含了对业务逻辑的解释,项目中难免有逻辑复杂之处,不加注释的代码,数日后自己看都会觉得陌生,更不要说其他人看了,今天分享一下Objective-C开发中常用的代码注释方式以及应用场合。

    注释形式

    注释形式主要有:

    单行注释,多行注释,方法注释,方法集注释(配合代码块实现快速注释)

    1. 单行注释

    使用 // 注释单行代码,最常见的使用场景是在方法内注释某个属性或某块区域的含义,如下图:

    2. 多行注释

    使用 /** 文本 **/ 的注释格式(快捷键cmd+alt+/)可以对属性和类以及方法进行注释,与//不同的是,该注释方式可以写多行,一般使用在类的头文件,多行介绍当前类的含义,如下图:

    3. 方法注释

    与方法2相同,使用 /** 文本 **/ 的注释格式(快捷键cmd+alt+/)可以对方法进行注释,快捷键会根据方法参数自动生成需要填写的注释内容,并且在其他地方使用该方法时,Xcode会智能提示出之前写的注释内容,如下图:

    在方法上方使用快捷键 cmd+alt+/:

    使用该方法时显示注释内容:

    4:方法集注释(配合代码块实现快速注释)

    先介绍一下,何为方法集注释,通常没有添加方法集的类是这样的:

    为了快速定位类中的某块代码,或某个方法,Xcode为我们提供了方法集的注释方式,可大大减少搜寻目标代码的时间,如图:

    这样就能对类中的方法和??橐焕牢抻?,要查找或修改的时候可以迅速定位,节省时间,提高自我体验。

    实现方法:

    ( #pragma mark  <#注释的内容#> )

    但是每次敲这些字符一定不是你想要的效果,在Xcode8之前可以使用VVDocumenter增强版(个人在原基础上修改添加方法集注释功能),由于Xcode8默认禁用使用插件,所以我们采用代码块+快捷键的方式来实现,效果也是酸爽:

    上图中,就是我使用代码块+快捷键来实现的方法集注释,编写方便,快捷,具体实现步骤如下:

    添加代码块并设置快捷键:

    这样就大功告成,保存代码块,在代码中使用预设的快捷键,编译器会自动提示,回车,输入即可。

    记得代码块预设的时候“注释内容外要用<#>” 。

    搜索CocoaChina微信公众号:CocoaChina
    微信扫一扫
    订阅每日移动开发及APP推广热点资讯
    公众号:
    CocoaChina
    我要投稿   收藏文章
    上一篇:图层的contents,contentsGravity,contentsRectangle,contentsCenter
    我来说两句
    发表评论
    您还没有登录!请登录注册
    所有评论(0

    综合评论

    相关帖子

    sina weixin mail 回到顶部
  • 山西税务系统一次性“打包”12项业务 2019-10-13
  • 江干区结对帮扶西藏那曲教育玩转“一对一”“多对一” 2019-10-11
  • 6月15日一分钟阅尽天下军情 2019-10-11
  • 赌王四太家的豪宅曝光,网友:一点都不羡慕 ——凤凰网房产 2019-10-10
  • 郭碧婷曝杨幂怀孕趣事,杨幂实力学习台湾腔 2019-10-10
  • 川航成功备降获赞还需反思 提直降代倒逼OTA服务提升 2019-10-10
  • 旅游--北京频道--人民网 2019-09-19
  • 山东将推动各类保护区范围内煤矿有序退出 2019-09-19
  • 史上最大锦鲤!南京大二女生一次收到618个快递 2019-09-14
  • 俄罗斯球队为国争光,为普京争脸。揭幕战横扫沙特队,吸引世界眼球。一代伟人普京,是俄罗斯人民的福气,强国,强军、富民,是普京献词“地球盛宴”的真正荣耀时刻,俄国人 2019-09-14
  • 海军第27批护航编队结束对摩洛哥访问  2019-09-05
  • 【脱贫路上】衣比·衣明: 小庭院里巧增收 2019-09-05
  • 华媒:瑞士失业率创历史新低 技术型劳动力短缺 2019-09-04
  • 告别“电钻音”安静“不扰民” 九阳率先推出静音破壁机 2019-09-01
  • 《歌手》首发阵容6年来最尬?令我震惊的只有…… 2019-08-23
  • 每天送6元本金的斗地主 足球低水稳赚 重庆时时彩软件 北京pk拾直播开奖结果 大赢家足球比分310 998彩票 分分pk10安卓计划软件 时时彩7码5期倍投方案 新时时彩宝典下载 北京塞车pk10计划软件全能版?