编程规范:Google C++的命名与头文件指南
需积分: 9 183 浏览量
更新于2024-08-07
收藏 523KB PDF 举报
"命名约定-ug编程基础知识,Google C++编码规范"
在编程中,命名约定是确保代码可读性和可维护性的重要方面。本文主要关注C++编程中的一些命名规则,尤其是根据Google的C++编码规范。这些规则旨在提高代码的一致性和清晰度,使其他开发者能更轻松地理解和协作。
### 1. 通用命名规则 (General Naming Rules)
#### 描述性命名
- 函数、变量和文件名应该具有描述性,避免过度缩写。这样做的目的是让阅读代码的人无需查看声明就能理解它们的作用。例如:
```cpp
int num_errors; // 好的命名,清楚地表示这是一个错误计数器。
int num_completed_connections; // 好的命名,表明这是已完成连接的数量。
```
#### 类型和变量命名
- 类型通常使用名词,比如`Customer`, `Order`等,而函数名通常使用"命令性"动词,如`createOrder`, `processPayment`等。这反映了它们在程序中的角色和功能。
### 2. Google C++ 编码规范
Google C++编码规范提供了关于头文件组织、命名、注释、错误处理等方面的详细指导。以下是一些关键点:
#### 二、头文件
- 头文件应该只包含它们需要的声明,并且尽可能减少相互依赖。
- 使用`#include`指令时,推荐使用 angled brackets `<file.h>`对于标准库,而使用双引号`"file.h"`对于项目内的头文件。
#### 类型命名
- 类型(包括类、结构体、枚举等)通常采用`CamelCase`,如`MyClassName`。
- 变量和函数名使用`snake_case`,如`myVariable`,`myFunction`。
#### 命名空间
- 使用命名空间来避免名字冲突,如`namespace myLibrary { ... }`。
#### 常量命名
- 常量通常使用全大写字母和下划线分隔的`CONSTANT_CASE`,如`MAX_CONNECTIONS`。
#### 预处理器宏
- 尽量减少对预处理器宏的使用,因为它们可能导致代码难以理解和调试。
- 如果必须使用,宏名也应遵循全大写字母的规则,如`MY_MACRO`。
#### 函数和方法
- 函数名和方法名应清楚地表明其作用,例如`calculateTotalPrice()`。
- 构造函数名称与类名相同,不带参数的构造函数可以是默认构造函数。
#### 变量声明
- 尽量避免全局变量,但如果必须使用,其命名应清楚表明其作用和范围。
#### 错误处理
- 使用异常处理机制来报告和处理错误,而不是返回错误代码。
Google C++编码规范还包括许多其他细节,如注释风格、代码布局、模板和继承等。遵循这些规范可以帮助创建出高质量、易于维护的代码库,同时提高团队间的合作效率。在实际开发中,理解和应用这些规则是至关重要的。
388 浏览量
2023-07-29 上传
117 浏览量
101 浏览量
101 浏览量
点击了解资源详情
195 浏览量
101 浏览量
一土水丰色今口
- 粉丝: 23
- 资源: 3953
最新资源
- 对ASP.NET MVC项目中的视图做单元测试.txt
- java面试题 面试 java
- AJAX and java(英文)
- java程序员面试题
- Java最著名的开源项目
- Java领域的十大产品
- U盘 硬盘 文件夹自定义图标及背景
- IDL用戶培訓教程(初級入門)
- 屏蔽浏览器的后退按钮
- 如何在虚拟机安装Linux
- GEC2410开发板实战手册
- CCNA Boson NetSim 入门实战
- ps技巧,使用的一些常用技巧
- Configuring_FICO_Lawrence_Rebello
- Eclipse in Action A Guide for the Java Developer.pdf
- Struts快速学习指南