C/C++编程规范指南
2022/2/10 14:21:41
本文主要是介绍C/C++编程规范指南,对大家解决编程问题具有一定的参考价值,需要的程序猿们随着小编来一起学习吧!
前言
文章内容由林锐编写的《高质量C/C++编程指南》结合自身在学习中遇到的困难整理出来的常见问题。希望帮助大家,快速了解一些编程规范。
一、文件结构
每个C/C++程序通常分为两个文件。一个文件用于保存程序的声明(declaration),称为头文件。另一个文件用于保存程序的实现(implementation),称为定义(definition)文件。
C/C++程序的头文件以“.h”为后缀,C程序的定义文件以“.c”为后缀,C++程序的定义文件通常以“.cpp”为后缀。
1.1 头文件的结构
- 【规则 1-1-1】为了防止头文件被重复引用,应当在头文件的第一行添加 #pragma once,也可以用ifdef/define/endif结构产生预处理块。
- 【规则 1-1-2】用 #include <filename.h> 格式来引用标准库的头文件(编译器将从标准库目录开始搜索)。
- 【规则 1-1-3】用#include “filename.h” 格式来引用非标准库的头文件(编译器将从用户的工作目录开始搜索)。
- 【建议 1-1-1】头文件中只存放"声明",而不存放"定义"。
- 【建议 1-1-2】不提倡使用全局变量,尽量不要在头文件中出现像 entern int value 这类声明。
#prama once //防止头文件被重复引用 #include <math.h> //引用标准库的头文件 #include "myheader.h" //引用非标准库的头文件 void Function1(…); //全局函数声明 class Box //类结构声明 { ... }
1.2 定义文件的结构
定义文件有两部分内容: 1. 对头文件的引用。 2. 程序的实现体(包括数据和代码)。
#include "myheader.h" //引用头文件 //全局函数的实现体 void Function1(...) { ... } //类成员函数的实现体 void Box::Draw(...) { ... }
1.3 头文件的作用
(1)通过头文件来调用库功能。在很多场合,源代码不便(或不准)向用户公布,只要向用户提供头文件和二进制的库即可。用户只需要按照头文件中的接口声明来调用库功能,而不必关心接口怎么实现的。编译器会从库中提取相应的代码。
(2)头文件能加强类型安全检查。如果某个接口被实现或被使用时,其方式与头文件中的声明不一致,编译器就会指出错误,这一简单的规则能大大减轻程序员调试、改错的负担。
二、程序的版式
版式虽然不会影响程序的功能,但会影响可读性。程序的版式追求清晰、美观,是程序风格的重要构成因素。
2.1 空行
空行起着分隔程序段落的作用。空行得体(不过多也不过少)将使程序的布局更加清晰。
- 【规则 2-1-1】在每个类声明之后、每个函数定义结束之后都要加空行。
- 【规则 2-1-2】在一个函数体内,逻辑上密切相关的语句之间不加空行,其他地方应加空行分隔。
2.2 代码行
- 【规则 2-2-1】一行代码只做一件事情,如只定义一个变量,或只写一条语句。这样代码容易阅读,并且方便于写注释。
- 【规则 2-2-2】if、for、while、do等语句独占一行,执行语句不得紧随其后。不论执行语句有多少都要加{}。这样可以防止书写失误。
- 【建议 2-2-1】尽可能在定义变量的同时初始化该变量。以防止忘记初始化,引用了未被初始化的变量,可能会导致程序错误。
2.3 注释
注释通常用于: (1)函数借口的说明; (2)重要代码行或段落提示。
- 【规则 2-3-1】注释是对代码的“提示”,而不是文档。程序中的注释不可喧宾夺主,注释太多了会让人眼花缭乱。注释的花样要少。
- 【规则 2-3-2】边写代码边注释,修改代码同时修改相应的注释,以保证注释与代码的一致性。不再有用的注释要删除。
- 【规则 2-3-3】注释的位置应与被描述的代码相邻,可以放在代码的上方或右方,不可以放在下方。
- 【规则 2-3-4】当代码比较长,特别是有多重嵌套时,应当在一些段落的结束处加注释,便于阅读。
三、命名规则
- 【规则 3-1-1】标识符应当直观且可以拼读,可望文知意,不必进行“解码”。标识符最好采用英文单词或其组合,便于记忆和阅读。切忌使用汉语拼音来命名。
- 【规则 3-1-2】程序中不要出现仅靠大小写来区分的相似的标识符。
例如:
int x, X; //变量x与X容易混淆 void foo(int x); //函数foo与FOO容易混淆 void FOO(float x);
- 【规则 3-1-3】变量的名字应当使用 “名词” 或者 “形容词+名词”。
例如:
float value; float oldValue; float newValue;
- 【规则 3-1-4】全局函数的名字应当使用 “动词” 或者 “动词+名词” (动宾组合)。类的成员函数应当只使用 “动词”,被省略的名词就是对象本身。
例如:
DrawBox(); //全局函数 box->Draw(); //类的成员函数
- 【规则 3-1-5】用正确的反义词组命名具有互斥意义的变量或相反动作的函数等。
例如:
int minValue; int maxValue; int setValue(...); int getValue(...);
- 【规则 3-2-1】类名和函数名用大写字母开头的单词组合而成。
例如:
class Node; //类名 class LeafNode; //类名 void Draw(...); //函数名 void SerValue(...); //函数名
- 【规则 3-2-2】变量和参数用小写字母开头的单词组合而成。
例如:
int drawMode; float minValue;
- 【规则 3-2-3】常量全用大写字母,用下划线分隔单词。
例如:
const int MAX = 100; const int MAX_LENGTH = 100;
- 【规则 3-2-4】静态变量加前缀s_(表示static)。
例如:
static int s_initValue; //静态变量
- 【规则 3-2-5】全局变量加前缀g_(global)。
例如:
int g_howManyPeople; //全局变量 int g_howMuchMoney; //全局变量
- 【规则 3-2-6】类的数据成员函数加前缀m_(表示member,也可以加前缀_ 或 后缀_),这样可以避免数据成员与成员函数的参数同名。
例如:
void Object::SetValue(int width, int height) { m_width = width; m_height = height; }
四、表达式和基本语句
4.1 运算符的优先级
- 【规则 4-1-1】如果代码中的运算符比较多,用括号确定表达式的操作顺序,避免使用默认的优先级。
例如:
word = (high << 8) | low if ((a | b) && (a & c))
4.2 复合表达式
如a = b = c = 0这样的表达式称为复合表达式。允许复合表达式存在的理由是: (1)书写简洁; (2)可以提高编译效率。 但要防止滥用复合表达式。
- 【规则 4-2-1】不要编写太过复杂的复合表达式。
例如:
i = a >= b && c < d && c + f <= g + h; //复合表达式过于复杂
- 【规则 4-2-2】不要有多用途的复合表达式。
例如:
d = (a = b = c) + r; //该表达式既求a值又求d值。应当拆分为两个独立的语句: a = b + c; d = a + r;
- 【规则 4-2-3】不要把程序中的复合表达式与 “真正的数学表达式” 混淆。
例如:
if (a < b < c) //a < b < c是数学表达式而不是真正的程序表达式 //并不表示 if ((a < b) && (b < c)) //而是 if ((a < b) < c)
4.3 if 语句
4.3.1 布尔变量与零值比较
- 【规则 4-3-1】不可将布尔变量直接与true、false或是1、0进行比较。根据布尔类型的语义,零值为“假”(记为false),任何非零值都是“真”(记为true)。true的值究竟是什么并没有统一的标准。
假设布尔变量名字为flag,它于零值比较标准的if语句如下:
if (flag) //表示flag为真 if (!flag) //表示flag为假
4.3.2 整型变量与零值比较
- 【规则 4-3-2】应当将整型变量用 “==” 或 “!=” 直接与0比较。
假设整型变量的名字为value,它与零值比较的标准if语句如下:
if (value == 0) if (value != 0) //不可模仿布尔变量的风格而写成 if (value) //会让人误解 value 是布尔变量 if (!value)
4.3.3 浮点变量与零值比较
- 【规则 4-3-3】不可将浮点变量用 “==” 或 “!=” 与任何数字比较。因为无论是 float 还是 double 类型的变量,都有精度限制。所以要设法转化成 “>=” 或 “<=” 形式。
假设浮点变量的名字为x,应当将
if (x == 0.0) //隐含错误的比较 //转化为 if ((x >= -EPSINON) && (x <= EPSINON)) //其中EPSINON是允许的误差(即精度)
4.3.4 指针变量于零值比较
- 【规则 4-3-4】应当将指针变量用 “==” 或 “!=” 直接与NULL比较。
指针变量的零值是 “空”(记为NULL)。尽管NULL的值与0相同,但是两者意义不同。假设指针变量的名字为p,它与零值比较的标准if语句如下:
if (p == NULL) //p与NULL显式比较,强调p是指针变量 if (p != NULL) //不要写成 if (p == 0) //容易让人误解p是整型变量 if (p != 0) //或者 if (p) if (!p) //容易让人误解p是布尔变量
4.3.5 对if语句的补充
有时我们可能会看到 if (NULL == p) 这样奇怪的形式。这是为了防止将 if (p = = NULL) 误写成 if (p = NULL),而颠倒二者顺序,编译器会认为 if (NULL = p) 是错误的,而 if (p = NULL)是合法的。因为NULL不能被赋值。
4.4 for循环
- 【规则 4-4-1】不可在for循环内修改循环变量,防止for循环失去控制。
- 【建议 4-5-1】建议for语句的循环控制变量的取值采用 “半开半闭区间” 写法(更加直观)。
例如:
for (int x = 0; x < N; x++) //起点到终点间隔为N,循环次数为N for (int x = 0; x <= N 1; x++) //起点到终点间隔为N-1,循环次数为N
4.5 switch语句
- 【规则 4-5-1】每个case语句的结尾不要忘了加break,否则将导致多个分支重叠(除非有意使多个分支重叠)。
- 【规则 4-5-2】不要忘记最后加上default分支,即使程序不需要default处理。为了防止别人认为你忘了default处理。
五、常量
5.1 为什么需要常量
如果不使用常量,直接在程序中填写数字或字符串,将会有什么麻烦?
(1)程序的可读性(可理解性)变差。程序员自己会忘记那些数字或字符串是什么意思,用户则更加不知它们从何处来、表示什么。
(2)在程序的很多地方输入同样的数字或字符串,难保不发生书写错误。
(3)如果要修改数字或字符串,则会在很多地方改动,既麻烦又容易出错。
- 【规则 5-1-1】尽量使用含义直观的常量来表示那些将在程序中多次出现的数字或字符串。
例如:
#define MAX 100 //宏常量,结尾不能加分号 const int MAX = 100; //const常量
5.2 const 与 #define 的比较
C/C++语言可以用const来定义常量,也可以用#define来定义常量。但是前者比后者有更多的优点:
(1)const常量有数据类型,而宏常量没有数据类型。编译器可以对前者进行类型安全检查。而对后者只进行字符替换,没有类型安全检查,并且在字符替换可能会产生意料不到的错误(边际效应)。
(2)有些集成化的调试工具可以对const常量进行调试,但是不能对宏常量进行调试。(因为宏替换发生在预处理阶段)
- 【规则 5-2-1】在C/C++中只使用const常量而不使用宏替换。
这篇关于C/C++编程规范指南的文章就介绍到这儿,希望我们推荐的文章对大家有所帮助,也希望大家多多支持为之网!
- 2024-10-04el-table 开启定时器下,表格的选中状态会消失是什么原因-icode9专业技术文章分享
- 2024-10-03如何安装和初始化飞牛私有云 fnOS?-icode9专业技术文章分享
- 2024-10-03如何安装 App 并连接到飞牛 NAS?-icode9专业技术文章分享
- 2024-10-03如何安装飞牛 TV 并连接到影视服务器?-icode9专业技术文章分享
- 2024-10-03如何在PVE和ESXI上安装飞牛私有云 fnOS?-icode9专业技术文章分享
- 2024-10-03fnOS国产最强NAS安装系统异常情况处理-icode9专业技术文章分享
- 2024-10-03飞牛NAS如何创建存储空间?-icode9专业技术文章分享
- 2024-10-03fnOS国产最强NAS硬盘会自动休眠吗?-icode9专业技术文章分享
- 2024-10-03fnOS国产最强NAS如何安装飞牛影视和创建媒体库?-icode9专业技术文章分享
- 2024-10-03fnOS国产最强NAS如何为家人朋友开通影视账号?-icode9专业技术文章分享