当前位置:首页 > 技术 > 正文内容

_rqy的OI代码风格规范

访客 技术 2026年6月16日 1

本文介绍在信息学竞赛(OI)中采用的代码编写规范,源自 _rqy 长期实践,并参考了 Google 代码风格与 Menci 的相关标准。

基础原则

  • #include 指令必须位于文件最顶部,且仅允许一次。
  • 禁止使用 using namespace std;。如需使用特定名称,应写为 using std::cout; 等形式。
  • 单行字符长度不得超过 80 个。

预处理指令

  • 头文件顺序建议:先 C++ 标准库,再 C 标准库,最后是其他自定义或交互库。若为独立模块,其对应头文件应放在第一个 #include
  • 在竞赛环境下,所有 #include 应按字典序排列。
  • 统一使用尖括号格式:#include <foo>,避免使用双引号。
  • 多层嵌套的 #if #endif 必须添加注释标明配对关系。
  • 尽量避免宏定义(#define),优先使用 consttypedefinline 等更安全的替代方式。
  • 所有预处理指令不得缩进,保持顶格。

缩进与空格

  • 每个代码块使用 2 个空格进行缩进。
  • 大括号不换行,始终与前一行内容在同一行。
  • 需要加空格的情况:
    • 二元运算符(如 +=)两侧;逗号和分号除外。
    • 逗号和分号后方(除非位于行尾)。
    • iffor 等控制语句与左括号之间。
    • do-while 中的 while 与前一个右大括号之间;if-else 中的 else 与前一个右大括号之间。
    • 所有左大括号左侧(根据不换行规则,左大括号不应出现在行首)。
    • ?: 两侧,包括构造函数初始化列表中的冒号。
    • 类型声明中 *& 的左侧,例如:const int& a, int A(int*& a)
    • 花括号与其内部语句或初始化列表之间(若在同一行)。
    • 常量成员函数的 const 关键字两侧。
  • 禁止加空格的情况:
    • 小括号或中括号与其内部表达式之间。
    • 函数名与左括号之间(包括声明、定义和调用)。
    • 单目运算符(如 !-*&~)之后,或自增自减操作符与其操作数之间。
    • 逗号和分号左侧。
    • 类型中 *& 的右侧。
    • .->:: 两侧。
    • operator 与所重载运算符之间(运算符与参数列表之间也按此规则处理)。
  • 长表达式可换行,运算符置于行首;缩进应使逻辑对齐清晰;高优先级子表达式建议加括号以防止歧义。
  • 参数列表或初始化列表过长时可换行,逗号置于行尾,缩进四空格。
  • 极短函数可写成一行(但总长度不可超过 80 字符),此时花括号内需有空格(空函数体 {} 除外)。

示例代码

struct VeryLongStruct {
  int veryLongMember, data;
  VeryLongStruct(int x, int y, int z, int w)
      : veryLongMember(x) {
    this->data = y + z * w;
  }
};

inline int min_val(int a, int b) { return a < b ? a : b; }

int gcd(int a, int b) {
  return b ? gcd(b, a % b) : a;
}

int main() {
  int var1 = 2, var2 = 23;
  VeryLongStruct obj(
      var1,
      var1,
      var2,
      var2
  );
  printf("%d\n", obj.data);
  return 0;
}

空行规则

  • #includeusing 之间不允许空行,之后必须空一行。
  • 一组常量定义前后应有空行。
  • 函数或结构体定义前后应留空行(多个短小函数如 minmax 可省略空行)。
  • 全局变量定义组上下需空行。
  • 语句间可根据逻辑意义适当插入空行。
  • 禁止出现连续两个及以上空行。

函数定义规范

  • main 函数必须返回 int,且不可省略 return 0;
  • 类/结构体参数传递应优先使用引用,避免不必要的拷贝。
  • 极简函数可写成一行(不超过 80 字符),花括号内需保留空格(空函数体除外)。
  • 单个函数不宜过长(一般不超过 100 行)。

命名约定

  • 常规命名采用驼峰法:变量小写开头,函数/类/结构体大写开头。
  • 结构体或类的成员函数可小写开头。

特殊命名规则

  • main 函数。
  • 变量可用单个小写字母命名。
  • 全局数组名可使用一个大写字母加 0~2 位数字,如 AT1F01
  • 模板函数或通用工具函数:如 readIntpowMod
  • 算法缩写:如 KMPCRTNTTCDQ
  • 简短的 inline 函数:如 minupd(表示更新操作)。
  • 常量使用大写字母:如 NM
  • 临时变量可以下划线开头,如 _tmp

完整示例

#include <algorithm>
#include <cctype>
#include <cstdio>

typedef long long LL;

inline int read_int() {
  int res = 0, ch;
  while (!isdigit(ch = getchar()));
  do res = res * 10 + ch - '0';
  while (isdigit(ch = getchar()));
  return res;
}

const int MOD = 998244353;
const int GEN = 3;
const int MAXN = 200050;

inline LL pow_mod(LL base, int exp) {
  LL ans = 1;
  for ((exp += MOD - 1) %= (MOD - 1); exp; exp >>= 1, (base *= base) %= MOD)
    if (exp & 1) (ans *= base) %= MOD;
  return ans;
}

LL inv[MAXN];
int n;

void NTT(LL* arr, int len, int opt) {
  for (int i = 1, j = 0; i < len; ++i) {
    int k = len;
    while (~j & k) j ^= (k >>= 1);
    if (i < j) std::swap(arr[i], arr[j]);
  }

  for (int h = 2; h <= len; h <<= 1) {
    LL wn = pow_mod(GEN, (MOD - 1) / h * opt);
    for (int j = 0; j < len; j += h) {
      LL w = 1;
      for (int i = j; i < j + (h >> 1); ++i) {
        LL tmp1 = arr[i], tmp2 = arr[i + (h >> 1)] * w;
        arr[i] = (tmp1 + tmp2) % MOD;
        arr[i + (h >> 1)] = (tmp1 - tmp2) % MOD;
        (w *= wn) %= MOD;
      }
    }
  }

  if (opt == -1)
    for (int i = 0; i < len; ++i)
      (arr[i] *= -(MOD - 1) / len) %= MOD;
}

LL F[MAXN], G[MAXN];
LL T1[MAXN * 4], T2[MAXN * 4];

void multiply(LL* A, int n, LL* B, int m) {
  int len = 1;
  while (len <= n + m) len <<= 1;

  for (int i = 0; i < len; ++i)
    T1[i] = (i < n ? A[i] : 0);
  for (int i = 0; i < len; ++i)
    T2[i] = (i < m ? B[i] : 0);

  NTT(T1, len, 1);
  NTT(T2, len, 1);
  for (int i = 0; i < len; ++i)
    (T1[i] *= T2[i]) %= MOD;
  NTT(T1, len, -1);
}

void solve(int l, int r) {
  if (l == r - 1) {
    F[l] = (l == 0 ? 1 : F[l] * inv[l] % MOD);
    return;
  }
  int mid = (l + r) >> 1;
  solve(l, mid);
  multiply(F + l, mid - l, G, r - l);
  for (int i = mid; i < r; ++i)
    (F[i] += T1[i - l]) %= MOD;
  solve(mid, r);
}

int main() {
  n = read_int();
  inv[1] = 1;
  for (int i = 2; i <= n; ++i)
    inv[i] = -(MOD / i) * inv[MOD % i] % MOD;

  for (int i = 1; i <= n; ++i) {
    scanf("%lld", &G[i]);
    (G[i] *= i) %= MOD;
  }

  solve(0, n + 1);

  for (int i = 1; i <= n; ++i)
    printf("%lld\n", (F[i] + MOD) % MOD);

  return 0;
}

相关文章

Linux crontab 详解

1) crontab 是什么cron 是 Linux 的定时任务守护进程;crontab 是用来编辑/查看“按时间周期执行命令”的表(cron table)。常见两类:用户 crontab:每个用户一份(crontab -e 编辑)系统级 crontab / cron.d:可指定执行用户(/etc/crontab、/etc/cron.d/*)2) crontab 时间...

富文本里可以允许的 HTML 属性

一、所有标签默认允许的安全属性(极少)class        (可选)id           (通常建议禁用)title️ 注意:id 容易被滥用做锚点注入,很多系统直接禁用class 允许的话最好只允许固定前缀(如 editor-*)二、a 标签允许属性<a href="" t...

Mac 安装 Node.js 指南

方法一:通过官网安装包(最简单,适合初学者)如果你只是想快速安装并开始使用,这是最直接的方法。访问 Node.js 官网。页面会显示两个版本:LTS (Recommended For Most Users):长期支持版,最稳定。建议选这个。Current:最新特性版,包含最新功能但可能不够稳定。下载 .pkg 安装包并运行。按照安装向导点击“下一步”即可完成。方法二:使用 Homebrew 安装(...

Dom\HTML_NO_DEFAULT_NS 的副作用:自动加闭合标签

在使用Dom\HTMLDocument时,Dom\HTML_NO_DEFAULT_NS 将禁止在解析过程中设置元素的命名空间, 此设置是为了与DOMDocument向后兼容而存在的。当使用它时,已知的一个副作用就是:自动加闭合标签例如 </img> 为什么会这样?当你使用:Dom\HTML_NO_DEFAULT_NS文档会变成 无命名空间模式,此时内部更接近 XML...

Laravel 事件和监听器创建

在 Laravel 中,使用 Artisan 命令创建 Events(事件) 和 Listeners(监听器) 是非常高效的。你可以通过以下几种方式来实现:1. 手动创建单个 Event如果你只想创建一个事件类,可以使用 make:event 命令:Bashphp artisan make:event UserRegistered执行后,文件将生成在 app/Even...

自定义域名解析神器 dnsmasq

什么是 dnsmasq?dnsmasq 是一个轻量级、功能强大的网络服务工具,专为小型和中等规模网络设计。它是一个综合的网络基础设施解决方案[1]。dnsmasq 能做什么?功能说明应用场景DNS 转发与缓存将 DNS 查询转发到上游服务器(ISP、Google DNS 等),并在本地缓存结果加快 DNS 查询速度,减少外部 DNS 流量本地 DNS解析本地网络设备的主机名,无需编辑&n...

发表评论

访客

◎欢迎参与讨论,请在这里发表您的看法和观点。