| 网站首页 | 业界新闻 | 小组 | 威客 | 人才 | 下载频道 | 博客 | 代码贴 | 在线编程 | 编程论坛
欢迎加入我们,一同切磋技术
用户名:   
 
密 码:  
共有 1482 人关注过本帖, 2 人收藏
标题:VFP学习、开发漫谈 (十)
只看楼主 加入收藏
liuxingang28
Rank: 11Rank: 11Rank: 11Rank: 11
来 自:山东济南
等 级:贵宾
威 望:47
帖 子:658
专家分:2180
注 册:2014-2-7
结帖率:96.88%
收藏(2)
 问题点数:0 回复次数:10 
VFP学习、开发漫谈 (十)
今天与大伙聊一聊有关代码中的“注释”问题。今天的问题,对于高手们来说可能过于简单了,权当抛砖引玉吧。

首先,需要弄明白以下几个问题。

第一:为什么要在程序中添加注释?

添加注释的目的,纯粹是为了提高代码的可读性。特别是,当你修改其他人编写的代码,或对自己很久以前开发的代码进行修改时,若没有注释,会很吃力。

第二:添加注释会不会增加程序的大小?

肯定会增加源代码的大小,但不会增加最终 EXE 文件的大小,因为在编译时会忽略注释。

第三:什么时候添加注释较合适呢?

我的看法是,对于新开发的项目,在分模块调试完成后添加注释是比较合适的。若在编写代码的过程中添加注释,可能会打断思路。时间隔的久了,又容易遗忘原来的编程意图和细节。

在对已有项目进行修改时,在修改的过程中应该即时添加注释,并且对每个修改点都应该添加,以说明本次修改的原因。另外,不要直接修改原代码,而应该将原代码注释掉,再在原代码的下方添加新代码。这样做的好处是,便于新代码出现问题时查找原因。当然,在程序运行一段时间,确认修改过的代码无问题后,也可以将以前注释掉的代码删除。

第四:既然注释这么重要,是否需要对每一行都添加注释?

不需要。我一般采取如下原则:

1. 对于自定义函数以及表单的自定义方法,在代码的开头添加注释行,说明代码的功能、参数和返回值。
图片附件: 游客没有浏览图片的权限,请 登录注册


2. 把代码按照功能划分成若干段,每段之间用空行分隔,并在每段的首行说明该段代码实现的功能
图片附件: 游客没有浏览图片的权限,请 登录注册


3. 一般来说,分支结构和循环结构都要添加注释。其他语句可根据用户的习惯和经验酌情处理。

4. 对于放在代码行后面的注释,最好使用 TAB 键与其他行的注释对齐,并使注释与代码保持一定的间距,这样,代码看起来更整洁

在对代码进行调试时,经常需要对代码添加注释标记,使其暂时不起作用,待调试完后再移去注释标记。对于单行代码,在行首添加 * 即可。对于多行代码,我一般使用“Format”菜单中的“Comment(注释)”和“Uncomment(取消注释)”。不过,频繁地选择菜单,太麻烦了,如果有一个快捷键就好了。

下面,我们就指定一个快捷键 Ctrl+M,当按下 Ctrl+M 时为选定代码添加注释标记。另外,再指定一个取消注释标记的快捷键 Shift+Ctrl+M

选择菜单“Tools - Macros”打开宏窗口,单击“New”按钮,在“Defined Key”文本框中按下 Ctrl+M,在“Macro contents(宏内容)”框中输入“{ALT+O}m”,如下图所示:
图片附件: 游客没有浏览图片的权限,请 登录注册


同理,再指定一个快捷键 Shift+Ctrl+M,不同的是,在“Defined Key”文本框中按下 Ctrl+Shift+M,在“Macro contents(宏内容)”框中输入“{ALT+O}n”,如下所示:
图片附件: 游客没有浏览图片的权限,请 登录注册


在下面的宏对话框中,单击“Set Default”按钮,使这里定义的宏一直有效:
图片附件: 游客没有浏览图片的权限,请 登录注册


选定多行代码,按下Ctrl+M 即可快速为选定行添加注释标记,再按下Shift+Ctrl+M 即可快速取消注释,十分方便。

记得在九十年代,我经常使用一个叫 CCED 的软件作为 Foxbase 的代码编辑器。其中有一项功能:若要删除一行代码,无需选定该行代码,只要按下 Ctrl+Y 即可。在 VFP 中能实现吗?

完全可以。同样,还是使用宏。按下图所示增加一个宏即可:
图片附件: 游客没有浏览图片的权限,请 登录注册


这个宏的意思是,先按下 HOME 键将光标移至行首,然后按下Shift+↓选定整行,最后按下 Ctrl+X 将整行剪切。

宏不能随意定义,特别是不要与系统定义的快捷键冲突。为此,在定义宏之前,先看一看系统菜单,了解哪些快捷键已被使用、哪些快捷键未被使用。

对于注释符“&&”,我再啰嗦几句:

1. “&&”既可以放在行首,使整行都作为注释行(此时,与 * 功能相同),也可以放在代码行的后面
2. “&&”与代码之间无需用空格分隔,当然,用 TAB 分隔更好
3. 在续行符“;”后,也可以添加“&&”注释,并不会影响当前行与下一行的关系

[ 本帖最后由 liuxingang28 于 2014-3-12 16:43 编辑 ]
搜索更多相关主题的帖子: 源代码 开发 项目 源代码 开发 项目 
2014-03-12 16:18
wengjl
Rank: 14Rank: 14Rank: 14Rank: 14
等 级:贵宾
威 望:109
帖 子:2232
专家分:3913
注 册:2007-4-27
收藏
得分:0 
在理,爱看,谢谢

只求每天有一丁点儿的进步就可以了
2014-03-12 16:30
hu9jj
Rank: 20Rank: 20Rank: 20Rank: 20Rank: 20
来 自:红土地
等 级:贵宾
威 望:400
帖 子:11857
专家分:43421
注 册:2006-5-13
收藏
得分:0 
注释的确非常重要,别说别人阅读程序,自己写的代码若不加注释,以后自己也很可能会忘记代码的用途。不光是注释,一个项目基本完成之后,还要养成将开发资料的整理归档习惯,以备以后程序维护改进之用。

活到老,学到老!http://www.(该域名已经被ISP盗卖了)E-mail:hu-jj@
2014-03-12 20:11
TonyDeng
Rank: 20Rank: 20Rank: 20Rank: 20Rank: 20
等 级:贵宾
威 望:304
帖 子:25859
专家分:48889
注 册:2011-6-22
收藏
得分:0 
排版很重要,注釋應適度,代碼必須分解。

授人以渔,不授人以鱼。
2014-03-13 00:15
tlliqi
Rank: 19Rank: 19Rank: 19Rank: 19Rank: 19Rank: 19
等 级:贵宾
威 望:204
帖 子:15453
专家分:65956
注 册:2006-4-27
收藏
得分:0 
以下是引用hu9jj在2014-3-12 20:11:31的发言:

注释的确非常重要,别说别人阅读程序,自己写的代码若不加注释,以后自己也很可能会忘记代码的用途。不光是注释,一个项目基本完成之后,还要养成将开发资料的整理归档习惯,以备以后程序维护改进之用。
言之有理
2014-03-13 07:28
sylknb
Rank: 4
等 级:贵宾
威 望:14
帖 子:1547
专家分:184
注 册:2006-6-3
收藏
得分:0 
虽是基础,但很有道理值得注意。
2014-03-14 09:37
Tiger5392
Rank: 12Rank: 12Rank: 12
等 级:贵宾
威 望:88
帖 子:2775
专家分:2237
注 册:2006-5-17
收藏
得分:0 
记得else,endif,endfor,enddo等语句后面加上的东西都看作是注释,无论是否加上“&&”

感言:学以致用。 博客:http://www./blog/user14/65009/index.shtml email:Tiger5392@
2014-03-14 09:42
wzxzh
Rank: 1
等 级:新手上路
帖 子:23
专家分:0
注 册:2014-6-10
收藏
得分:0 
巩固知识
2014-06-13 19:54
郭艳军
Rank: 1
等 级:新手上路
帖 子:36
专家分:0
注 册:2015-2-11
收藏
得分:0 
谢谢分享!
2015-02-13 11:54
月沐庭轩
Rank: 9Rank: 9Rank: 9
来 自:京城
等 级:贵宾
威 望:17
帖 子:393
专家分:1106
注 册:2011-7-24
收藏
得分:0 
学习了。

坚持学习vfp,QQ:306805680
2015-03-01 11:47
快速回复:VFP学习、开发漫谈 (十)
数据加载中...
 
   



关于我们 | 广告合作 | 编程中国 | 清除Cookies | TOP | 手机版

编程中国 版权所有,并保留所有权利。
Powered by Discuz, Processed in 0.046038 second(s), 10 queries.
Copyright©2004-2024, BCCN.NET, All Rights Reserved