CN·语言

标准库

13 个模块、190 个函数与类方法,全部用 CN 语言写成——每个函数都有定义、用法与可运行的示例。标准库自身就是最好的进阶教程。

全部函数速查

按模块列出全部公开 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)。