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

栏目: 编程工具 · IOS · 发布时间: 6年前

内容简介:iOS 注释方法大全 代码块加快捷键注释

注释规范

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

注释形式

注释形式主要有:

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

1. 单行注释

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

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

2. 多行注释

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

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

3. 方法注释

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

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

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

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

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

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

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

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

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

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

这样就能对类中的方法和模块一览无余,要查找或修改的时候可以迅速定位,节省时间,提高自我体验。

实现方法:

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

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

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

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

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

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

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

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

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


以上就是本文的全部内容,希望本文的内容对大家的学习或者工作能带来一定的帮助,也希望大家多多支持 码农网

查看所有标签

猜你喜欢:

本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们

世界因你不同

世界因你不同

李开复、范海涛 / 中信出版社 / 2010 / 29.8

这是李开复唯一的一本自传,字里行间,是岁月流逝中沉淀下来的宝贵的人生智慧和职场经验。捣蛋的“小皇帝”,11岁的“留学生”,奥巴马的大学同学,26岁的副教授,33岁的苹果副总裁,谷歌中国的创始人,他有着太多传奇的经历,为了他,两家最大的IT公司对簿公堂。而他的每一次人生选择,都是一次成功的自我超越。   透过这本自传,李开复真诚讲述了他鲜为人知的成长史、风雨兼程的成功史和烛照人生的心灵史,也首次全面......一起来看看 《世界因你不同》 这本书的介绍吧!

CSS 压缩/解压工具
CSS 压缩/解压工具

在线压缩/解压 CSS 代码

图片转BASE64编码
图片转BASE64编码

在线图片转Base64编码工具

HEX CMYK 转换工具
HEX CMYK 转换工具

HEX CMYK 互转工具