编程做好这六点,你就是大师了

  作者:areak 时间:2013-08-07来源:电子产品世界

  三、 添加尽可能详尽的注释

  不要总觉得自己当时记忆深刻,甚至刻骨铭心、终生难忘,时间总是会无情地证明你是错的,为你的程序添加详尽的注释,比如变量的用途、函数的调用关系、参数说明、函数功能等等都要尽可能详细地写明,有时候即使是写下来,过一段时间再回头看时还要在琢磨一阵,若是不写,后果可想而知,别人就更没法读你的程序了。

  这是我为一个函数写的注释,当然每个人都有自己的写法,我一般这样来写的,仅供参考哈。

  /*=============================================================================

  *
  * 函 数 名: CMD_Send()
  *
  * 参 数:        length_low 数据长度
  *                      CMD_byte 命令字节
  *                      CMD_parameter 命令参数
  *                      *data 语音数据
  * 功能描述:
  *                      发送一帧语音数据
  *
  * 返 回 值: 无
  =============================================================================*/

  四、 做好底层的定义

  这里的意思是与硬件相关的程序,为了后期更好地编程,先做一些必要的定义,比如
         #define cWL_PIN_SDIO 0x04
  #define SDIO_is_Out P1DIR |= cWL_PIN_SDIO

  这样以后用起来就十分的方便,就像说话一样,使得程序十分易读,当然凡事过犹不及,也没必要过多地定义,只对一些经常使用的定义就好,也有的编程环境中,本身就已经做了非常详尽的定义,那么就省了你的事了,但这也未必是好事,因为你要花很多时间去看,去熟悉。

  五、 合理划分单元和函数

  尤其在程序量比较大的时候,这一点就显得尤为重要,划分得好不好,对于后期编程影响极大。合理划分单元说得通俗点就是把每一个功能单元放在一个单独的文件中,这样每一个文件中的程序量就不至于太长,需要被外部调用的函数全部在头文件中引出,划分函数也很重要,函数划分得好,可以节省很多程序空间,增强代码执行效率。这样做的好处是极大地增强了程序的可移植性,下次再用到这个功能时,只需要修改底层的IO口就可以了,这样久而久之,当你写的单元足够多的时候,写程序就变得越来越轻松了。还有在文件的起始处最好也加一些功能说明,也就是注释,例如:

  /*=============================================================================

  * 说 明:
  *                本单元实现了语音输出‘宇音天下’的功能。
  * 作 者: XXX 2011/3/3
  *  =============================================================================*/

  六、 反复修改,精益求精

  无论我们如何用心的去编写程序,程序似乎总是有改进的余地,当你发现一个可以改进的地方,可能是一个好的算法,也可能仅仅是一个冗余的变量,也要不厌其烦地去重新改过,这样日积月累,就可以不断完善你自己的程序库,因为当程序库足够充足、足够完善的时候,写程序就几乎是信手拈来了。

  七、 总结

  其实以上说的程序设计几点经验,每一点都是在一个最根本的原则的指引之下,那就是增强程序的可读性和可移植性。最后送大家一句话,与大家共勉“If you will,you can!!!”。

1 2

关键词: 程序设计 函数 变量 编程 代码

加入微信
获取电子行业最新资讯
搜索微信公众号:EEPW

或用微信扫描左侧二维码

相关文章

查看电脑版