`
zhxy0234
  • 浏览: 5607 次
  • 性别: Icon_minigender_1
  • 来自: 大连
最近访客 更多访客>>
社区版块
存档分类
最新评论

2.源代码格式

阅读更多
源代码是软件的一个重要的组成部分,源代码格式不对,换句话说,源代码错误,肯定是软件错误。所以,把源代码编译没有错误等价为源代码正确,是错误的,把运行没有错误,等价为源代码正确,是错误的。

源代码格式的几点应该注意的事项(常识):
1、源代码的书写格式,应该体现源代码内部的逻辑关系;
2、源代码内部最重要的代码行是:空行;空行把代码分成各个相对独立的组成部分;
3、源代码内部第二重要的代码行是:注释行;
4、源代码行内最重要的字符是:空格;空格把代码行分成各个相对独立的组成部分;
5、源代码行内第二重要的字符是:制表符(Tab),制表符是行首缩进使用的字符;
6、注释合格的标准是:同等级技术能力的技术人员,可用比较方便的看懂代码;或者,应该从事该工作的技术人员可以容易的看懂;
7、注释行数应该占到总代码行数的三分之一;
8、每个源代码文件头部都必须有说明本文件功能的注释;
9、自己定义的每个函数都必须有说明函数功能的注释;
10、自己定义的每个变量都必须有说明变量功能的注释;
11、注释应该使用自己的母语(汉语);
12、一句注释合格的标准是,表达了需要表达的内容,语法正确;
13、清楚的注释能够方便代码阅读者理解代码的逻辑关系和各个函数的功能;
14、键盘上最重要的键是空格键,空格占英文文章的比例是20%左右;写软件源代码时,空格的比例也很大;所以,键盘上面积最大的键是空格;
分享到:
评论

相关推荐

    C语言源代码格式化 完工 V1.04 20120226 1946.7z

    C语言源代码格式化。 处理文件夹。 PLT2KMLX14解决最后一行的问题 20110721 0931.7z WPT2KMLx4解决空行末行 20110721 0948.7z WPTPLT2KMLx12PLTWPT初步 20110721 1006.7z OZI格式的轨迹文件转KML格式的轨迹文件...

    CoolFormat3.1_源代码格式化工具

    CoolFormat源代码格式化是一款C\C++\C#\CSS\HTML\Java\JavaScript\JSON\PHP\SQL\XML代码格式化工具。软件可以快速多种风格格式化,并对语言进行着色。界面采用Office 2010风格,并有多种样式可以替换。并且支持代码...

    c js 源代码格式化工具

    是一款C\C++\Java\C#代码格式化工具,使用的是Artistic Style技术,所以在参数化命令格式源代码时,参数选项跟Artistic Style的一样。软件可以快速多种风格格式化,并对语言进行着色。界面采用Office 2007风格,并有...

    C语言源代码格式化 完工 V1.01 20111224 1251.7z

    C语言源代码格式化。 处理文件夹。 PLT2KMLX14解决最后一行的问题 20110721 0931.7z WPT2KMLx4解决空行末行 20110721 0948.7z WPTPLT2KMLx12PLTWPT初步 20110721 1006.7z OZI格式的轨迹文件转KML格式的轨迹文件...

    CoolFormat源代码格式化工具 1.1

    CoolFormat源代码格式化工具 1.1 CoolFormat源代码格式化是一款C\C++\Java\C#代码格式化工具,使用的是Artistic Style技术,所以在参数化命令格式源代码时,参数选项跟Artistic Style的一样。软件可以快速多种风格...

    CoolFormat源代码格式化2.5

    CoolFormat源代码格式化2.5 CoolFormat 是一款源代码格式化软件,支持对 C/C++/Java/C#/JavaScript/HTML/XML/PHP/SQL 等代码进行快速批量格式化操作。软件界面默认采用Office 2007 风格,清新爽朗!你也可以设置为...

    C语言源代码格式化 完工 V1.02.7z )

    C语言源代码格式化。 处理文件夹。 PLT2KMLX14解决最后一行的问题 20110721 0931.7z WPT2KMLx4解决空行末行 20110721 0948.7z WPTPLT2KMLx12PLTWPT初步 20110721 1006.7z OZI格式的轨迹文件转KML格式的轨迹文件...

    C语言源代码格式化 完工 V1.08 20120801 1627.7z

    C语言源代码格式化。 处理文件夹。 PLT2KMLX14解决最后一行的问题 20110721 0931.7z PLT2KML 改CString完工 20120731 1632.7z WPT2KMLx4解决空行末行 20110721 0948.7z WPT2KML 改CString完工 20120731 1700.7z ...

    Android系统源代码情景分析光盘

    4.1 Logger日志格式....................................................... 75 4.2 Logger日志驱动程序.............................................. 76 4.2.1 基础数据结构.................................

    电子-CoolFormat3.2源代码格式化工具.zip

    电子-CoolFormat3.2源代码格式化工具.zip,单片机/嵌入式STM32-F0/F1/F2

    MCUTool.exe 源代码

    Hex/Bin文件转换为文本方式(变量定义方式),将Hex文件或Bin文件转换为C/ASM源代码格式的数据。 CRC计算,提供3种计算方法。 二进制比较,主要用于产品首件确认时,源hex文件与从产品中读出的文件进行比较。...

    蓝牙协议及其源代码分析.rar

    5.7 实现HCI 的部分源代码及其分析.......... PAGEREF _TOC120615691 \H 27 5.7.1 HCI 对上行数据流的处理过程......... PAGEREF _Toc120615692 \h 27 5 5.7.2 HCI 对下行数据流的处理过程......... PAGEREF _Toc...

    c# 29个非常好的源代码 适合初学者

    4.C#文本加密解密算法示例源代码.rar 5.C#在开机时自动启动程序.rar 6.C#自定义皮肤.rar 7.CS聊天程序.rar 8.WPF模拟Windows+7气象源码.rar 9.玻璃按钮.rar 10.导出Excel格式.rar 11.导出excel列表.rar 12.动态创建...

    C语言源代码格式化 完工 V1.05 20120229 1804.7z

    C语言源代码格式化 完工 V1.05 20120229 1804.7z 说明: 除非特别声明,所有程序均使用VC++6.0 MFC编写。 所有程序均为练手用,放弃一切权利,同时不承担任何责任。 显式遵照 GPL v3.0标准。 ...

    C语言源代码格式化 完工V1.00 20111024 2351.7z

    C语言源代码格式化 完工V1.00 20111024 2351.7z 说明: 除非特别声明,所有程序均使用VC++6.0 MFC编写。 所有程序均为练手用,放弃一切权利,同时不承担任何责任。 显式遵照 GPL v3.0标准。 QuoteCorrection ...

    Excel源代码_VBA代码

    (2) 源代码中完整的例子以Excel文件的形式保存,代码片断以文本文件的形式保存。部分代码提供了2种格式,可以根据阅读需要选择使用。 (3) 以Excel文件保存的代码打开时需要启用宏。 (4) 源代码的函数名、模块名...

    源代码统计工具(SourceCounter) 2..5.1.4

    免费的源代码统计分析工具,能够统计包括:代码行数、开发工数、项目成本、质量指标等项目信息,支持30多种源代码格式。具有统计迅速、准确的优点,是程序开发人员的必备工具。可以对 C++、VB.Net、VB、C#、JAVA、...

    C语言源代码格式化 完工 小文版本 V1.10 20120831 0955.zip

    C语言源代码格式化。 处理文件夹。 PLT2KMLX14解决最后一行的问题 20110721 0931.7z PLT2KML 改CString完工 20120731 1632.7z PLT2KML 20110811 1047 处理单文件.7z PLT2KML 20120813 1815 处理子目录.7z PLT2...

    i2c 源代码情景分析(Beta2)

    i2c 源代码情景分析(Beta2) 共67页,pdf格式

Global site tag (gtag.js) - Google Analytics