Android第四十一期 - 关于微信聊天的功能
最近做项目遇到的问题，ListView滚动会改变Position的数值，所以要加以修改，才能做到微信的滚动，语音列表不会乱串Animation，唉~为什么会有这么多的BUG呢？faint~继续努力了~ 代码已经整理好，效果如下： 本文转自 吴雨声 51CTO博客，原文链接：http://blog.51cto.com/liangxiao/1670679，如需转载请自行联系原作者
《从零开始学Swift》学习笔记（Day 57）——Swift编码规范之注释规范：
前面说到Swift注释的语法有两种：单行注释（//）和多行注释（/*...*/）。这里来介绍一下他们的使用规范。
-
文件注释
文件注释就在每一个文件开头添加注释，文件注释通常包括如下信息：版权信息、文件名、所在模块、作者信息、历史版本信息、文件内容和作用等。
下面看一个文件注释的示例：
|
1
2
3
4
5
6
7
8
9
10
11
12
|
/*
Copyright (C) 2015 EorientInc. All Rights Reserved.
See LICENSE.txtfor this sample’s licensing information
Description:
This file contains thefoundational subclass of NSOperation.
History:
15/7/22: Created by TonyGuan.
15/8/20: Add socketlibrary
15/8/22: Add math library
*/
|
这个注释只是提供了版权信息、文件内容和历史版本信息等，文件注释要根据自己实际情况包括内容。
-
文档注释
文档注释就是这种注释内容能够生成API帮助文档。文档注释主要对类型、属性、方法或函数等功能。
文档注释是稍微将单行注释（//）和多行注释（/*...*/）做一点“手脚”后，就成为了文档注释，单行文档注释（///）和多行文档注释（/**...*/）。
下面代码示例：
|
1
2
3
4
5
6
7
8
9
10
11
12
|
import
Foundation
/**
The protocol that types may implement ifthey wish to be
notified of significantoperation lifecycle events.
*/
protocol OperationObserver{
/// Invoked immediately prior to the`Operation`'s `execute()` method.
func operationDidStart(operation:Operation)
}
|
代码中使用了文档注释。
可以使用一些工具将这些文档注释生成API文件
-
代码注释
程序代码中处理文档注释还需要在一些关键的地方添加代码注释，文档注释一般是给一些看不到源代码的人看的帮助文档，而代码注释是给阅读源代码人参考的。代码注释一般是采用单行注释（//）和多行注释（/*...*/）。
有的时候也会在代码的尾端进行注释，这要求注释内容极短，应该在有足够的空白来分开代码和注释。尾端注释示例代码如下：
|
1
2
3
|
init(timeout:NSTimeInterval) {
self.timeout = timeout
//初始化
}
|
-
使用地标注释
随着编码过程深入，工程代码量会增加，任何在这大量的代码中能快速找到需要方法或者是刚才修改过代码呢？
在Swift代码中使用地标注释，然后就可以使用Xcode工具在代码中快速查找了。地标注释有三个：
-
MARK，用于方法或函数的注释。
-
TODO，表示这里代码有没有完成，还要处理。
-
FIXME，表示这里修改了代码。
这些注释会出现在Xcode的 Jump Bar中。来看一个示例：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
|
class
ViewController:UIViewController,
UITableViewDataSource, UITableViewDelegate {
var listTeams: [[String:String]]!
override func viewDidLoad() {
super
.viewDidLoad()
...
}
override func didReceiveMemoryWarning() {
super
.didReceiveMemoryWarning()
//TODO: 释放资源 //使用TODO注释
}
// MARK: UITableViewDataSource 协议方法 //使用MARK注释
func tableView(tableView: UITableView,
numberOfRowsInSection section: Int) -> Int {
return
self.listTeams.count
}
func tableView(tableView: UITableView,
cellForRowAtIndexPath indexPath: NSIndexPath) -> UITableViewCell {
let cellIdentifier =
"CellIdentifier"
let cell: UITableViewCell! = tableView
.dequeueReusableCellWithIdentifier(cellIdentifier,
forIndexPath: indexPath) as? UITableViewCell
// FIXME: 修改bug //使用了FIXME注释
let row = indexPath.row
let rowDict = self.listTeams[row] as[String:String]
...
return
cell
}
// MARK: UITableViewDelegate 协议方法 //使用MARK注释
func tableView(tableView: UITableView,
didSelectRowAtIndexPath indexPath: NSIndexPath) {
...
}
}
|
上述代码中使用三种地标注释，在使用时候后面要跟有一个冒号(:)。
注释之后如果使用呢？打开Xcode的 Jump Bar，如下图，这些地标注释会在下拉列表中粗体显示，点击列表项就会跳转到注释行。
本文转自 tony关东升 51CTO博客，原文链接：http://blog.51cto.com/tonyguan/1748343，如需转载请自行联系原作者
微信关注我们
原文链接：https://yq.aliyun.com/articles/406370
转载内容版权归作者及来源网站所有！
低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。
相关文章
发表评论
资源下载
更多资源
优质分享App
近一个月的开发和优化，本站点的第一个app全新上线。该app采用极致压缩，本体才4.36MB。系统里面做了大量数据访问、缓存优化。方便用户在手机上查看文章。后续会推出HarmonyOS的适配版本。
Mario
马里奥是站在游戏界顶峰的超人气多面角色。马里奥靠吃蘑菇成长，特征是大鼻子、头戴帽子、身穿背带裤，还留着胡子。与他的双胞胎兄弟路易基一起，长年担任任天堂的招牌角色。
Nacos
Nacos /nɑ:kəʊs/ 是 Dynamic Naming and Configuration Service 的首字母简称，一个易于构建 AI Agent 应用的动态服务发现、配置管理和AI智能体管理平台。Nacos 致力于帮助您发现、配置和管理微服务及AI智能体应用。Nacos 提供了一组简单易用的特性集，帮助您快速实现动态服务发现、服务配置、服务元数据、流量管理。Nacos 帮助您更敏捷和容易地构建、交付和管理微服务平台。
Rocky Linux
Rocky Linux（中文名：洛基）是由Gregory Kurtzer于2020年12月发起的企业级Linux发行版，作为CentOS稳定版停止维护后与RHEL（Red Hat Enterprise Linux）完全兼容的开源替代方案，由社区拥有并管理，支持x86_64、aarch64等架构。其通过重新编译RHEL源代码提供长期稳定性，采用模块化包装和SELinux安全架构，默认包含GNOME桌面环境及XFS文件系统，支持十年生命周期更新。
手机查看
扫码在手机上查看文章
扫描二维码，手机阅读更方便
热门标签
欢迎您来访！
登录后，您将获得更多功能！
第三方登录
热门文章
联系我们
有任何问题或合作意向欢迎联系我们
Email: 99873273@qq.com
QQ: 99873273