标准库
13 个模块、190 个函数与类方法,全部用 CN 语言写成——每个函数都有定义、用法与可运行的示例。标准库自身就是最好的进阶教程。
核心错误码枚举 + 交换/最小/最大/断言(泛型)5 个条目容器向量<T> / 链表<T> / 栈<T> / 队列<T>(RAII 自动释放)44 个条目映射集合映射<K,V>(哈希)/ 字符串映射<V> / 集合<T>31 个条目字符串扩展字符串转整数/浮点/布尔 + 替换/填充左/填充右/分割7 个条目算法排序/线性查找/二分查找/逆序/变换/计数/最大元素10 个条目正则正则引擎类:字面量/./字符类/锚定/量词/分组/或/转义4 个条目系统参数个数() / 参数(索引)2 个条目IO读取行/读取整数/读取浮点/打印到错误4 个条目文件打开/读取/写入/读取行/大小/关闭/存在/创建目录8 个条目时间当前时间戳/单调时钟毫秒/格式化时间3 个条目数学平方根/幂/正弦/余弦/正切/绝对值/向上取整/向下取整8 个条目随机数随机数生成器类(xoshiro256++)+ 播种扩散7 个条目线程新线程/并入线程 + 互斥锁<T>(类型化句柄)+ 六个过渡函数9 个条目内置函数打印族/字符串族/内存族/驻留/类型大小/复制/转移(无需导入)48 个条目
全部函数速查
按模块列出全部公开 API(内部辅助以「内部」徽章标注)。点击函数名跳转到逐函数文档。
| 模块 | 条目 | 一句话 |
|---|---|---|
| 核心 | 错误码 | 全库统一错误码:除零/越界/空指针/内存/文件/参数/未初始化/溢出 |
交换 | 泛型交换两个变量的值 | |
最小 | 泛型取较小值 | |
最大 | 泛型取较大值 | |
断言 | 运行期断言:条件为假即终止进程 | |
| 容器 | 向量() | 构造空向量 |
向量(其他) | 拷贝构造(深拷贝) | |
大小 | 元素个数 | |
容量 | 已分配容量(不等于元素数) | |
为空 | 是否为空 | |
追加 | 尾部追加元素 | |
插入 | 在指定位置插入元素 | |
读取 | 带检查下标读取(越界返回错误) | |
元素 | 下标直读(副本;越界即中止) | |
元素引用 | 零拷贝引用读写(Rust &v[i] 同款) | |
设置 | 覆盖指定位置元素 | |
删除 | 删除指定位置元素(前移补位) | |
预留 | 预分配容量 | |
清空 | 清空元素(容量保留) | |
析构元素 内部 | 编译器注入的元素析构挂点(勿调用) | |
析构被移除 内部 | 字符串槽释放挂点(勿调用) | |
移动元素 内部 | 元素移动挂点:memcpy + 源清零(勿调用) | |
链表() | 构造空链表 | |
链表(其他) | 拷贝构造(链游深拷) | |
大小 | 元素个数 | |
为空 | 是否为空 | |
追加 | 尾部追加 | |
头部追加 | 头部插入 | |
删除头部 | 摘除头元素 | |
删除尾部 | 摘除尾元素 | |
头部元素 | 直读头元素(空表即中止) | |
读取头部 | 带检查读头元素 | |
读取尾部 | 带检查读尾元素 | |
清空 | 清空链上全部元素 | |
取空闲槽 内部 | 内部:空闲链槽分配(勿调用) | |
归还槽 内部 | 内部:槽归还空闲链(勿调用) | |
压入 | 元素压栈 | |
弹出 | 弹出并返回栈顶 | |
栈顶 | 窥视栈顶(不弹出) | |
为空 | 是否为空栈 | |
大小 | 元素个数 | |
入队 | 元素入队尾 | |
出队 | 队首出队 | |
队首 | 窥视队首(不出队) | |
为空 | 是否为空队 | |
大小 | 元素个数 | |
清空 | 清空队列 | |
取空闲槽 内部 | 内部:空闲链槽分配(勿调用) | |
归还槽 内部 | 内部:槽归还空闲链(勿调用) | |
| 映射集合 | 映射() | 构造空映射 |
映射(其他) | 拷贝构造(深拷) | |
大小 | 键值对个数 | |
为空 | 是否为空 | |
设置 | 写入键值(存在即覆盖) | |
获取 | 按键取值(未命中=错误) | |
包含 | 键是否存在 | |
删除 | 删除键值对 | |
清空 | 清空全部键值 | |
释放内部数组 内部 | 内部:显式销毁数组(勿调用) | |
桶索引 内部 | 内部:散列函数(勿调用) | |
链查找 内部 | 内部:桶链查找(勿调用) | |
析构键值 / 析构值 内部 | 内部:字符串槽释放挂点(勿调用) | |
字符串映射() | 构造空字符串键映射 | |
设置 | 写入字符串键值 | |
获取 | 按键取值 | |
包含 | 键是否存在 | |
删除 | 删除字符串键值 | |
清空 / 拷贝构造 | 清空与深拷构造(暂无 大小/为空 成员) | |
析构键值 / 析构值 / 桶索引 / 链查找 / 释放内部数组 内部 | 内部:挂点与散列辅助(勿调用) | |
集合() | 构造空集合(惰性桶) | |
添加 | 添加元素(按位模式判等) | |
包含 | 是否包含值(位模式判等) | |
删除 | 按位模式删除 | |
大小 | 元素个数 | |
为空 | 是否为空 | |
清空 | 清空集合 | |
析构被移除 / 移动元素 / 数组前移 / 元素位模式 / 元素相等 / 桶序号 / 链查找 内部 | 内部:挂点与哈希辅助(勿调用) | |
查找键位置 | 键数组线性查找 | |
查找值位置 | 数据数组线性查找 | |
散列桶序号 | 共享散列:Knuth 乘法 + 掩码 | |
| 字符串扩展 | 字符串转整数 | 字符串 → 整64(失败返回错误) |
字符串转浮点 | 字符串 → 浮64 | |
字符串转布尔 | 字符串 → 布尔 | |
替换 | 全量子串替换 | |
填充左 | 左侧补字符至目标长度 | |
填充右 | 右侧补字符至目标长度 | |
分割 | 按分隔符切分到调用方数组 | |
| 算法 | 排序整32 | 整32 数组冒泡升序 |
排序整64 | 整64 数组冒泡升序 | |
线性查找 | 泛型线性查找(未找到=无) | |
二分查找整32 | 整32 二分查找(须已升序) | |
二分查找整64 | 整64 二分查找(须已升序) | |
逆序 | 原地反转数组 | |
变换整32 | 整32 数组逐元素翻倍 | |
变换整64 | 整64 数组逐元素翻倍 | |
计数 | 统计目标值出现次数 | |
最大元素 | 泛型取数组最大值 | |
| 正则 | 正则引擎(模式串) | 构造正则引擎 |
搜索 | 找首个匹配起点(无匹配=无) | |
完全匹配 | 整串是否被模式完整覆盖 | |
匹配或 / 匹配序列 / 贪婪循环 / 匹配原子 / 类含 内部 | 内部:递归匹配器五个方法(勿调用) | |
| 系统 | 参数个数 | 参数个数(含程序名,≥1) |
参数 | 按下标取命令行参数 | |
| IO | 读取行 | 读一行输入(返回拥有型字符串) |
读取整数 | 读一个整数 | |
读取浮点 | 读一个浮点数 | |
打印到错误 | 写标准错误流(不换行) | |
| 文件 | 打开文件 | 打开文件拿句柄 |
写入文件 | 写字符串到文件(返回字节数) | |
读取文件 | 按字节块读取 | |
读取文件行 | 按行读取 | |
文件大小 | 查询文件字节数 | |
关闭文件 | 关闭句柄 | |
文件存在 | 文件是否存在 | |
创建目录 | 递归创建目录(幂等) | |
| 时间 | 当前时间戳 | Unix 纪元秒 |
单调时钟毫秒 | 单调毫秒时钟(测耗时用) | |
格式化时间 | strftime 风格格式化(本地时区) | |
| 数学 | 平方根 | 平方根 |
幂 | 乘方 | |
正弦 | 正弦(弧度) | |
余弦 | 余弦(弧度) | |
正切 | 正切(弧度) | |
绝对值 | 浮点绝对值 | |
向上取整 | 向上取整 | |
向下取整 | 向下取整 | |
| 随机数 | 随机数生成器(种子) | 以种子构造(同种子同序列) |
播种 | 运行中重播种 | |
下一个 | 整64 全域随机值 | |
下一个范围 | [0, 上限) 均匀整数 | |
下一个浮点 | [0.0, 1.0) 均匀浮点 | |
旋转左 / 扩散混合 内部 | 内部:位运算辅助(勿调用) | |
播种扩散 | 熵源混合成优质种子 | |
| 线程 | 新线程 | 启动新线程 |
并入线程 | 等待线程并取返回值 | |
互斥锁(初值) | 创建类型化互斥锁 | |
上锁 | 加锁(阻塞) | |
解锁 | 解锁 | |
互斥锁新建 | 过渡 API:裸锁句柄 | |
互斥锁上锁 | 过渡 API:裸锁加锁 | |
互斥锁解锁 | 过渡 API:裸锁解锁 | |
互斥锁释放 | 过渡 API:销毁裸锁 | |
| 内置函数 | 打印 | 变参打印(末尾自动换行) |
打印行 | 变参打印(不换行) | |
格式化 | sprintf 风格格式化为新字符串(宽位占位符+编译期配对执法) | |
IO::读取行 | 输入内置:读一行(见 IO 模块包装) | |
字符串长度 | 字节长度 | |
字符串比较 | 内容相等(== 同义) | |
字符串字典序 | 字典序(负/0/正) | |
字符串连接 | 拼接(+ 同义,可接数值) | |
字符串复制 | 复制为拥有型新串 | |
字符串查找 | 找子串下标(未找到 -1) | |
字符串子串 | 字节切片 | |
字符串大写 | 转大写 | |
字符串小写 | 转小写 | |
字符串修剪 | 去两端空白 | |
字符串反转 | 字节序反转 | |
字符串包含 | 是否含子串 | |
字符串前缀 | 是否以指定前缀开头 | |
字符串后缀 | 是否以指定后缀结尾 | |
整数转字符串 | 整64/整128 → 字符串 | |
浮点转字符串 | 浮64 → 字符串 | |
字符转字符串 | 字符 → 字符串 | |
布尔转字符串 | 布尔 → "真"/"假" | |
正数转字符串 | 正64/正128 → 字符串 | |
字符串释放 | 手动释放(一般用不到) | |
字符串构建器::新建 | 创建构建器句柄 | |
字符串构建器::追加 | 追加字符串段 | |
字符串构建器::追加字节 | 追加单字节 | |
字符串构建器::完成 | 收尾取字符串 | |
字符串构建器::弃置 | 放弃构建器 | |
分配 | malloc | |
重新分配 | realloc(>2GiB 拒绝) | |
释放 | free | |
复制内存 | memcpy | |
置零内存 | memset 0 | |
内存::活动分配数 | 未释放块数(泄漏检测) | |
内存::总分配次数 | 累计分配次数 | |
内存::总分配字节 | 累计分配字节 | |
内存::竞技场分配 | 竞技场 bump 分配 | |
内存::竞技场重置 | 整场释放 | |
内存::竞技场活动字节 | 竞技场用量 | |
内存::释放全部 | 全堆释放(收尾用) | |
类型大小 | 类型字节宽度 | |
复制 | 泛型深拷贝克隆 | |
转移 | 所有权移交(转移后禁读) | |
运行时错误 | 带码终止进程 | |
驻留 | 字符串 → 唯一 ID | |
驻留文本 | ID → 文本(借用) | |
驻留计数 | 唯一内容数 |
阅读约定
- 结果<T, 整32> 必须检查——把返回值直接当语句丢弃是编译错误 (「返回值被丢弃未检查」)。本文全部示例遵守此规则。
- 不安全 = 手动内存/裸指针域函数,须在
不安全函数或块内调用;标准库容器类方法多为不安全(容器内部管理堆内存), 但使用容器本身不需要不安全块——析构自动释放(RAII)。 - 内部 = 实现细节条目(编译器注入挂点/散列辅助), 供读源码者对照,不建议业务代码直接调用。
- 示例输出经本地编译器实际运行验证(
cn build+ 比对 stdout)。