新手关于ios代码注释问题

Question

本帖最后由 yangfanacc 于 2013-10-21 17:37:58 编辑

Answer 1

iOS里面的注释也差不多啊，“//”注释一行，“/* */”注释一段，#param  这种注释一般是用来内容分段的，算是解释下面的方法的作用吧
其他感觉区别是不很大。

Answer 2

同上，#param  解释多个方法，//解释单个方法

Answer 3

显然我不需要这样的答案啊，我需要的是注释的规范，例如对于每个类的.m文件是不是需要注释说明作用，是不是每个方法都需要说明用处以及whatwhatwhat等等，期待答案，

Answer 4

X﹏X。。注释这个东西。。仁者见仁智者见智啊，你想写清楚一点也行，完全不写都可以不过如果你说规范的话，参考Apple官方的demo的话
1）项目里面有个readMe.txt，这个主要是介绍性的注释，版本更新啊、以及一些重要类的讲解与用法。
2）.h与.m前面一般有一大段无用的责任声明还是什么的，有些有一点简单的介绍。不是重点注释，关于方法的介绍都丢在readMe了。
3）"//"的话，用在需要简单注释的地方，用法比较灵活
4）#param  用在大段的内容开头，用于分割与上文的方法。就比如
#param  UITableViewDelegate
.....
#param  UITableViewDataSource
...这就说明上面一段是讲UITableViewDelegate 代理里面的方法，然后UITableViewDataSource就是另一个代理咯。注释这个东西别太纠结- -因为好的代码是不需要太多注释的，一看就懂。

Answer 5

X﹏X。。注释这个东西。。仁者见仁智者见智啊，你想写清楚一点也行，完全不写都可以不过如果你说规范的话，参考Apple官方的demo的话
1）项目里面有个readMe.txt，这个主要是介绍性的注释，版本更新啊、以及一些重要类的讲解与用法。
2）.h与.m前面一般有一大段无用的责任声明还是什么的，有些有一点简单的介绍。不是重点注释，关于方法的介绍都丢在readMe了。
3）"//"的话，用在需要简单注释的地方，用法比较灵活
4）#param  用在大段的内容开头，用于分割与上文的方法。就比如
#param  UITableViewDelegate
.....
#param  UITableViewDataSource
...这就说明上面一段是讲UITableViewDelegate 代理里面的方法，然后UITableViewDataSource就是另一个代理咯。注释这个东西别太纠结- -因为好的代码是不需要太多注释的，一看就懂。最好在前面加一个param  -

Answer 6

X﹏X。。注释这个东西。。仁者见仁智者见智啊，你想写清楚一点也行，完全不写都可以不过如果你说规范的话，参考Apple官方的demo的话
1）项目里面有个readMe.txt，这个主要是介绍性的注释，版本更新啊、以及一些重要类的讲解与用法。
2）.h与.m前面一般有一大段无用的责任声明还是什么的，有些有一点简单的介绍。不是重点注释，关于方法的介绍都丢在readMe了。
3）"//"的话，用在需要简单注释的地方，用法比较灵活
4）#param  用在大段的内容开头，用于分割与上文的方法。就比如
#param  UITableViewDelegate
.....
#param  UITableViewDataSource
...这就说明上面一段是讲UITableViewDelegate 代理里面的方法，然后UITableViewDataSource就是另一个代理咯。注释这个东西别太纠结- -因为好的代码是不需要太多注释的，一看就懂。谢谢你，

Answer 7

X﹏X。。注释这个东西。。仁者见仁智者见智啊，你想写清楚一点也行，完全不写都可以不过如果你说规范的话，参考Apple官方的demo的话
1）项目里面有个readMe.txt，这个主要是介绍性的注释，版本更新啊、以及一些重要类的讲解与用法。
2）.h与.m前面一般有一大段无用的责任声明还是什么的，有些有一点简单的介绍。不是重点注释，关于方法的介绍都丢在readMe了。
3）"//"的话，用在需要简单注释的地方，用法比较灵活
4）#param  用在大段的内容开头，用于分割与上文的方法。就比如
#param  UITableViewDelegate
.....
#param  UITableViewDataSource
...这就说明上面一段是讲UITableViewDelegate 代理里面的方法，然后UITableViewDataSource就是另一个代理咯。注释这个东西别太纠结- -因为好的代码是不需要太多注释的，一看就懂。谢谢你，
给分撒。。

Answer 8

X﹏X。。注释这个东西。。仁者见仁智者见智啊，你想写清楚一点也行，完全不写都可以不过如果你说规范的话，参考Apple官方的demo的话
1）项目里面有个readMe.txt，这个主要是介绍性的注释，版本更新啊、以及一些重要类的讲解与用法。
2）.h与.m前面一般有一大段无用的责任声明还是什么的，有些有一点简单的介绍。不是重点注释，关于方法的介绍都丢在readMe了。
3）"//"的话，用在需要简单注释的地方，用法比较灵活
4）#param  用在大段的内容开头，用于分割与上文的方法。就比如
#param  UITableViewDelegate
.....
#param  UITableViewDataSource
...这就说明上面一段是讲UITableViewDelegate 代理里面的方法，然后UITableViewDataSource就是另一个代理咯。注释这个东西别太纠结- -因为好的代码是不需要太多注释的，一看就懂。谢谢你，
给分撒。。好的，谢谢你，分都给你，