此规范参考:Codeforces上 Jiangly 的码风, Menci 代码规范,知乎 pansz 的回答
总纲
- 不再使用
using namespace std
- 不建议使用
#include <bits/stdc++.h>
- Tab 用于缩进,空格用于对齐(可不对齐)
- 左括号不换行(左括号前有且仅有一个空格)
- 头文件必须全部写在开头,C的头文件必须以c开头而非
.h
结尾 main
函数必须在整个程序末尾- 常用函数尽量写成类和模板形式
- 尽量使用STL减少代码量
空行
- 不能有两个连续空行
- 独立的代码块之间要有空行
- 头文件块、函数、成员函数、结构体、类,全局变量块之间必须用空行隔开
空格
空格的作用:识别族群的位置
- 前后必须都有空格:冒号、双目运算符、三目运算符
- 前加后不加:
* &
- 后加前不加:关键字,逗号
- 前后都不加:
. -> ::
函数和变量
- 传参时按照实际需要传 引用、const引用、值
- 尽量不使用全局变量
- 局部变量在用时定义
- 在合适的时间使用
static
变量
命名
- 统一使用驼峰命名法
- 常量,
typedef
定义的类型 全部大写 - 类私有变量以
_
开头 - 函数和变量统一使用小驼峰
- 结构和类统一使用大驼峰
- 以Core结尾的核心代码是在约束条件下的高效代码
- 以S结尾的是简单且效率较低的代码
注释
- 代码尽量自注释
- 在函数最开始注释,解释输入输出变量
代码优先级
- 普通代码:正确,可行,可读,通用
- Core代码:正确,高效,通用,可读
STL的使用
vector<bool>
不是vector
类型,谨慎使用- 尽量用
vector
取代用户输入的数组,而非开足够大的数组 - 尽量使用
emplace_back
取代push_back
,有些取代不了,就不取代了 - 多使用
pair, tuple, sort, stable_sort, iota, accumulate, for_each, lambda函数
使得代码更加优雅
代码规范的说明
空格的作用是区分,空格缩进理论上是不合理的,强烈抵制四个空格代替Tab
双目运算符两边加空格是为了 区分运算符 和 变量,虽然a+b
(这种代码不必加空格,但是为了养成好习惯,还是加上较好),关键字后面加空格是为了避免像 函数调用
工程中不推荐使用 using namespace std
,而且不用的时候你就会知道一些陌生的函数原来是std中的,并且以后修改起来很麻烦
不建议使用万能头文件,但是本人用了是因为,打CF等比赛的时候你一个个的敲头文件或者写一大堆头文件,还不如就写这一个,并且以后修改成不用万能头文件也很容易
左空格不换行完全是个人喜好,换不换都可以,固定就好
其它总纲的代码规范完全是为了代码通用美感,大道至简
尽量避免全局变量是因为防止程序不可控,降低代码耦合性,局部变量用的时候定义是为了增加代码可读性,static
变量也是为了避免全局变量
驼峰命名的好处在于 “顾名思义,望文生义”(贬义褒用) 遵守代码规范,养成编程好习惯~
代码规范示例:
#include <bits/stdc++.h>
const int N = 1e7 + 2;
bool isP[N];
std::vector<int> p;
// O(N log N), 可以写O(N)的算法,但没必要
void initPrime() {
if(isP[2]) return;
isP[2] = true;
for (int i = 3; i < N; i += 2) isP[i] = true;
for (int i = 3; i < N; i += 2) if (isP[i]) {
for (int j = 3; j * i < N; j += 2) {
isP[i * j] = false;
}
}
p.emplace_back(2);
for (int i = 3; i < N; i += 2) if (isP[i]) {
p.emplace_back(i);
}
}
int isPrime(int n) {
if(!isP[n]) return 0;
return std::lower_bound(p.begin(), p.end(),n) - p.begin() + 1;
}
int main() {
//freopen("in","r",stdin);
std::ios::sync_with_stdio(false);
std::cin.tie(nullptr);
initPrime();
int n;
while (std::cin >> n) {
if (n < 1 || n > N) {
std::cout << "Too small or too big, input again!" << std::endl;
} else if (int np = isPrime(n)) {
std::cout << n << " is " << np << "th prime number!" << std::endl;
} else {
std::cout << n << " is not a prime number!" << std::endl;
}
}
return 0;
}