| 网站首页 | 业界新闻 | 小组 | 威客 | 人才 | 下载频道 | 博客 | 代码贴 | 在线编程 | 编程论坛
欢迎加入我们,一同切磋技术
用户名:   
 
密 码:  
共有 1270 人关注过本帖
标题:今日散分帖,顺便问个程序注释问题。
取消只看楼主 加入收藏
hellovfp
Rank: 16Rank: 16Rank: 16Rank: 16
等 级:禁止访问
威 望:30
帖 子:2976
专家分:7697
注 册:2009-7-21
收藏
得分:0 
回复 23楼 TonyDeng
一般i,j,k偶也没有注释,觉得很明了的变量,无须多解释。

我们都在路上。。。。。
2011-08-19 13:51
hellovfp
Rank: 16Rank: 16Rank: 16Rank: 16
等 级:禁止访问
威 望:30
帖 子:2976
专家分:7697
注 册:2009-7-21
收藏
得分:0 
回复 22楼 TonyDeng
没有注释的程序读起来很蛋疼呀,每个初学者都应该一开始就学习编码规范的,不过大多数初学者没有意识到,等意识到的时候,已经形成习惯不写注释了。

我们都在路上。。。。。
2011-08-19 13:54
hellovfp
Rank: 16Rank: 16Rank: 16Rank: 16
等 级:禁止访问
威 望:30
帖 子:2976
专家分:7697
注 册:2009-7-21
收藏
得分:0 
回复 26楼 njkido
嗯,这个开源工具蛮好的,听说过,还未曾使用,搞一个玩玩去。

我们都在路上。。。。。
2011-08-19 14:00
hellovfp
Rank: 16Rank: 16Rank: 16Rank: 16
等 级:禁止访问
威 望:30
帖 子:2976
专家分:7697
注 册:2009-7-21
收藏
得分:0 
回复 27楼 TonyDeng
如果是变量名能很清楚的表名意图呢?
如程序片段中
   char buffer[BUFSIZ];
        int found = 0;
如果按规定非i,j,k之类的应该注释,但偶却怕过份注释,没有写,有时候看到别人的代码好象也没有注释,有点纠结了。

我们都在路上。。。。。
2011-08-19 14:03
hellovfp
Rank: 16Rank: 16Rank: 16Rank: 16
等 级:禁止访问
威 望:30
帖 子:2976
专家分:7697
注 册:2009-7-21
收藏
得分:0 
还有个问题:如果这样设计函数错误信息设置,是否合理?
程序代码:
#ifndef CERROR_H_INCLUDED
#define CERROR_H_INCLUDED

int g_nerror = -1;

const char *error_msg[] = {
        "invoke ok",            // 0 函数调用成功
        "alloc memory faile",   // 1 内存分配失败
        "string not init",      // 2 字符串未初始化附值
        "string not equal",     // 3 字符串不相等
        "out of index range"    // 4 索引超出范围
};

int             get_last_error(void);        //获取最后一次函数调用错误值
const char *    get_error_msg(int errro);    //获取对应的错误信息

#endif // CERROR_H_INCLUDED




[ 本帖最后由 hellovfp 于 2011-8-19 14:12 编辑 ]

我们都在路上。。。。。
2011-08-19 14:09
hellovfp
Rank: 16Rank: 16Rank: 16Rank: 16
等 级:禁止访问
威 望:30
帖 子:2976
专家分:7697
注 册:2009-7-21
收藏
得分:0 
回复 31楼 TonyDeng
呵呵。有道理,匈牙利命名法则偶也不大喜欢,喜欢直接用小写加下划线。

我们都在路上。。。。。
2011-08-19 14:27
hellovfp
Rank: 16Rank: 16Rank: 16Rank: 16
等 级:禁止访问
威 望:30
帖 子:2976
专家分:7697
注 册:2009-7-21
收藏
得分:0 
回复 32楼 TonyDeng
那就好,偶发现过多的不同返回值反倒使函数设计变得复杂,本想采用每个函数最后添加一个整形指针用于存储错误的方式,但发现可能会给使用者带来不必要的麻烦,
刚写的代码,以前的代码看来都要根据这个错误设计重新修改了,唉,设计不是一件简单的事。

我们都在路上。。。。。
2011-08-19 14:31
快速回复:今日散分帖,顺便问个程序注释问题。
数据加载中...
 
   



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

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