ICode9

精准搜索请尝试: 精确搜索
首页 > 其他分享> 文章详细

本学期代码规范(参考Google代码规范)+ 《数学之美》读后感

2021-09-15 22:05:10  阅读:151  来源: 互联网

标签:语句 读后感 代码 规范 注释 操作符 混排 空格


本学期代码规范(参考Google代码规范)

  • 排版格式
  1. 程序块要采用缩进风格编写,缩进的空格数为4个。
  2. 相对独立的程序块之间、变量说明之后须加空行。
  3. 较长的语句(>80字符)要分成多行书写,长表达式要在低优先级操作符处划分新行,操作符放在新行之首,划分出的新行要进行适当的缩进,使排版整齐,语句可读,一行程序以小于80字符为宜,不要写得过长。
  4. 不允许把多个短语句写在一行中,即一行只写一条语句。
  5. if、for、do、while、case、switch、default等语句自占一行,且if、for、do、while等语句的执行语句无论多少都要加括号{}。
  6. 在两个以上的关键字、变量、常量进行对等操作时,它们之间的操作符之前、之后或者前后要加空格;进行非对等操作时,如果是关系密切的立即操作符(如- >),后不应加空格。
    (1)逗号、分号只在后面加空格。
    (2)比较操作符,赋值操作符“=”、“+=”,算术操作符“+”、“%”,逻辑操作符“&&”、“&”,位域操作符“<<”、“^”等双目操作符的前后加空格。
    (3)"!"、"~"、"++"、"--"、"&"(地址运算符)等单目操作符前后不加空格。
    (4)"->"、"."前后不加空格。
    (5)if、for、while、switch等与后面的括号前应加空格,使if等关键字更为突出、明显。
  • 标识符命名
  1. 标识符的命名要清晰、明了,有明确含义,同时使用完整的单词或大家基本可以理解的缩写,避免使人产生误解。
  2. 命名规范必须与所使用的系统风格保持一致,并在同一项目中统一,比如采用UNIX的 全小写加下划线的风格或大小写混排的方式,不要使用大小写与下划线混排的方式,用作特殊 标识如标识成员变量或全局变量的m_和g_,其后加上大小写混排的方式是允许的。
  3. 用正确的反义词组命名具有互斥意义的变量或相反动作的函数等。
  • 可读性
  1.  注意运算符的优先级,并用括号明确表达式的操作顺序,避免使用默认优先级。 说明:防止阅读程序时产生误解,防止因默认的优先级与设计思想不符而导致程序出错。
  2. 源程序中关系较为紧密的代码应尽可能相邻。
  • 注释
  1. 一般情况下,源程序有效注释量必须在20%以上。 说明:注释的原则是有助于对程序的阅读理解,在该加的地方都加了,注释不宜太多也不 能太少,注释语言必须准确、易懂、简洁。
  2. 说明性文件(如头文件.h文件、.inc文件、.def文件、编译说明文件.cfg等)头部应 进行注释,注释必须列出:版权说明、版本号、生成日期、作者、内容、功能、与其它文件的 关系、修改日志等,头文件的注释中还应有函数功能简要说明。
  3. 函数头部应进行注释,列出:函数的目的/功能、输入参数、输出参数、返回值、调用 关系(函数、表)等。
  4. 边写代码边注释,修改代码同时修改相应的注释,以保证注释与代码的一致性。不再有用的注释要删除。
  5. 注释应与其描述的代码相近,对代码的注释应放在其上方或右方(对单条语句的注释) 相邻位置,不可放在下面,如放于上方则需与其上面的代码用空行隔开。
  6. 注释与所描述内容进行同样的缩排。

 

《数学之美》读后感

         阅读了《数学之美》书中余弦定理和新闻的分类这一章节。看似毫不相干的余弦定理,却可以应用计算机准确地对各个新闻网站自动分类。读完之后发现,数学原来并不只是枯燥的考试题,而是人类理解世界最重要的一种工具。吴军博士用生动形象的语言,结合数学发展的历史和实际的一手案例,谈古论今,在书中系统地阐述了与现代科技领域相关的数学理论的起源、发展及其作用。其最大价值也在于没有直接告诉你答案,而是让你带着新的启示、新的方法以及新的眼光、新的境界来重新理解这个世界。

标签:语句,读后感,代码,规范,注释,操作符,混排,空格
来源: https://www.cnblogs.com/nefertari-lx/p/15291088.html

本站声明: 1. iCode9 技术分享网(下文简称本站)提供的所有内容,仅供技术学习、探讨和分享;
2. 关于本站的所有留言、评论、转载及引用,纯属内容发起人的个人观点,与本站观点和立场无关;
3. 关于本站的所有言论和文字,纯属内容发起人的个人观点,与本站观点和立场无关;
4. 本站文章均是网友提供,不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属;如您发现该文章侵犯了您的权益,可联系我们第一时间进行删除;
5. 本站为非盈利性的个人网站,所有内容不会用来进行牟利,也不会利用任何形式的广告来间接获益,纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。

专注分享技术,共同学习,共同进步。侵权联系[81616952@qq.com]

Copyright (C)ICode9.com, All Rights Reserved.

ICode9版权所有