CN·语言

词法结构

源文件、注释、字面量、关键字全表、运算符与 13 级优先级——语法的原子层。

源文件与注释

项规定
扩展名.cn
编码UTF-8(必须)
入口入口文件内须定义 主 函数,签名恒为无参:函数 主() -> 整32(0=成功)——文件名 主.cn 仅为约定,与函数名无强制绑定
入口带参拒绝:C 风格 主(整32 个数, 字符** 表) 形态不合成无参入口符号 cn_main(编译器按无参约定合成、运行时启动代码引用)→ 链接期拒绝(诊断「链接失败」)
命令行参数经内置 系统::参数个数()(含可执行文件名本身)与 系统::参数(索引)(argv[0]=可执行文件名;越界返回 无)获取,无需导入;参数字符串由运行时持有,不得 字符串释放
入口退出码主 返回 结果<整32, E> 时:正常 → 退出码取 .值;失败 → 退出码取 .错误(Rust Termination 同构)
单行注释// 注释
块注释/* 注释 */——支持嵌套

主带参.cn(负例·链接期拒绝)CN

函数 主(整32 个数, 字符** 参数) -> 整32 {
    返回 个数;                  // ✗ 入口签名恒为无参:不合成 cn_main
}

主.cnCN

函数 主() -> 整32 {
    打印("===== 系统库(Task 6.5)=====");

    // ==================== 1. 参数个数(含可执行文件名本身) ====================
    整64 个数 = 系统::参数个数();
    打印("参数个数: ", 个数);             // 3(exe + hello + CN语言)

    // ==================== 2. 参数按索引取 argv ====================
    打印("参数个数>=1: ", 个数 >= 1);     // 1

    // argv[0]:可执行文件名本身(非空)
    字符* 程序名 = 系统::参数(0);
    如果 (程序名 != 无) {
        打印("argv[0]非空: ", 字符串长度(程序名) > 0);  // 1
    } 否则 {
        打印("argv[0]为空");
    }

    // argv[1]:hello
    字符* 参数一 = 系统::参数(1);
    如果 (参数一 != 无) {
        打印("argv[1]: ", 参数一);        // hello
    } 否则 {
        打印("argv[1]为空");
    }

    // argv[2]:CN语言(中文参数)
    字符* 参数二 = 系统::参数(2);
    如果 (参数二 != 无) {
        打印("argv[2]: ", 参数二);        // CN语言
    } 否则 {
        打印("argv[2]为空");
    }

    // 越界:超出 argc-1 → nullptr → 失败
    字符* 越界 = 系统::参数(99);
    如果 (越界 != 无) {
        打印("越界参数: ", 越界);
    } 否则 {
        打印("越界参数失败");             // 失败
    }

    打印("===== 系统库测试完成 =====");
    返回 0;
}

输出:===== 系统库(Task 6.5)===== 参数个数: 3 参数个数>=1: 真 argv[0]非空: 真 argv[1]: hello argv[2]: CN语言 越界参数失败 ===== 系统库测试完成 =====

系统参数实测(E2E 37_system·参数注入 你好/CN)CN

// —— 主.cn ——(E2E runner 注入命令行参数:你好、CN)
函数 主() -> 整32 {
    打印("参数个数: ", 系统::参数个数());       // 3(exe + 你好 + CN)
    打印("argv[1]: ", 系统::参数(1));          // 你好
    打印("argv[2]: ", 系统::参数(2));          // CN
    返回 0;
}

关键字全表:46 个保留字 + 上下文关键字

保留字在任何标识符位都不可用(字段名/变量名/函数名/参数名一概拒绝);上下文关键字只在固定语法位识别,不占用命名空间——你完全可以有叫 模块 或 公开 的变量。

分类保留字
控制流(10)如果 否则 当 循环 返回 中断 继续 选择 情况 默认
类型(21)整数 小数(别名);整8/16/32/64/128;正8/16/32/64/128;浮32 浮64;布尔 字符 字符串 空类型 结构体 联合体 枚举
声明(3)函数 变量 导入
安全(1)不安全
常量(3)真 假 无
OOP(5)类 接口 自身 父类 友元
错误处理(2)结果 可选
泛型(1)泛型
上下文关键字唯一语法位置
原始 多行字符串字面量前缀位(后紧跟引号才是前缀)
公开 私有 保护可见性标签位(公开: 等)
静态 常量声明前缀位(顶层/局部/循环初始/类成员)
虚拟 重写 抽象类/接口成员修饰位(后随 函数)
作为重命名导入位(导入 路径 作为 别名)
模块顶层声明位(后随标识符即声明)
运算符 遍历 每个 属于 对运算符重载/遍历循环固定形态
正常 错误 某些内置构造器名(结果/可选构造位)

字面量

整数字面量

主.cnCN

函数 主() -> 整32 {
    整64 甲 = 0xFF;                // 255
    整64 乙 = 0b1010;              // 10
    整64 丙 = 0o777;               // 511
    整64 丁 = 42L;                 // 42
    整64 戊 = 7U;                  // 7
    整64 己 = 36028797018963968;   // 2^55(超 imm32 域十进制)
    整64 庚 = 0x7FFFFFFFFFFFFFFF;  // 2^63-1(int64 正上界)
    整64 辛 = -255;                // 负常量(补码 neg 路径)
    打印(甲);
    打印(乙);
    打印(丙);
    打印(丁);
    打印(戊);
    打印(己);
    打印(庚);
    打印(辛);
    如果 (甲 == 255 && 乙 == 10 && 丙 == 511 && 丁 == 42 && 戊 == 7) {
        如果 (己 == 36028797018963968 && 庚 == 9223372036854775807 && 辛 == 0 - 255) {
            返回 0;
        }
    }
    返回 1;
}

输出:255 10 511 42 7 36028797018963968 9223372036854775807 -255

  • 后缀(仅整数字面量可带):L→整64、LL→整128、U→正32、UL→正64、ULL→正128(浮点后缀 f/F 见下文浮点字面量)。
  • 无后缀大字面量超出 整64 域时提升为 整128(在整128 域内求值)。
  • 不支持数字下划线分隔。

浮点字面量

  • 单精度后缀:f / F(大小写等价)→浮32——1.5f、2.5F、1.5e10f 同义;负号字面量同面(-1.5f 按浮32 传参与重载决议)。
  • 无后缀→浮64(双精度为默认契约态):2.5 与 2.5f 恒定级相异;浮点字面量无窄化豁免通道——浮32 丁 = 3.14; 拒,f/F 后缀是浮32 定级的唯一书写方式。
  • 后缀仅浮点形态(含小数点或指数 e/E)可带;整数形态尾缀 f/F 非后缀面。
  • 十六进制面 F 是数字位不是后缀:0xFF 为整数字面量。

字符与字符串字面量

主.cnCN

函数 主() -> 整32 {
    打印(原始"正则: ^\d+\.\d+$");
    打印(原始"路径: C:\dir\file");
    打印(多行"""甲
乙""");
    打印(原始多行"""a\nb""");
    打印("普通: \n[换行]");
    返回 0;
}
// 496 撞号改号让位,原号 459

输出:正则: ^\d+\.\d+$ 路径: C:\dir\file 甲 乙 a\nb 普通: [换行]

  • 常用转义:\n 换行、\t 制表、\0 空、\\ 反斜杠、\" 引号、\u{码点}。
  • 原始"..." 反斜杠原样;多行"""...""" 跨行(内部仍处理转义);原始多行"""...""" 完全原始。

运算符与 13 级优先级

优先级运算符说明
13(最高)() [] . ++ -- ?后缀:调用/下标/成员/后缀自增自减(值=原值)/后缀错误传播
12! ~ - ++ -- * &一元:非/按位非/负/前缀自增自减(值=新值)/解引用/取地址
11* / %乘除余
10+ -加减(字符串 + 数值 自动拼接)
9<< >>移位(超宽=确定性失败:常量移位量编译期硬错误、变量移位量错误码 8;丢高位不属检查对象)
8< <= > >=关系(字符串=字典序)
7== !=相等(字符串=内容比较)
6&按位与
5^按位异或
4|按位或
3&&逻辑与(短路)
2||逻辑或(短路)
1.5条件 ? 真值 : 假值三元(右结合·惰性求值)
1(最低)= += -= …赋值与复合赋值
  • 位运算仅整型;>> 有符号=算术右移、无符号=逻辑右移;~x ≡ x ^ -1。
  • 成员访问统一 .,指针左侧自动解引用一级;-> 已废除(仅保留于返回类型标注 -> 类型)。
  • &类变量 产对象地址(非句柄槽地址);&标量/结构体 =槽地址。
  • 类/结构体可重载的运算符集合与决议规则见类与对象·运算符重载。

语句终止:分号强制

每条语句必须以 ; 结束(C/Rust 同款);换行是纯空白,表达式内可自由续行。行尾漏分号=语法错误(诊断「语句缺少分号 ';'」),不存在自动分号插入——行首/行尾词法拼接类事故被结构性根除。

  • 空语句非法:裸 ; 不合法(诊断「预期表达式」)——合法的空循环体写 当(x) { }(空块合法)。
  • 循环体强制块:当(x); 是语法错误(诊断「预期 '{'」)——当/循环/如果 的体一律 { },不做单语句体。
  • 单行多语句合法:变量 a = 1; 变量 b = 2; 由分号分隔,行内最后一条同样须 ;;行内块 { x = 1; } 内部语句同样强制分号。
  • } 自终结:块/如果/当/循环/选择体、函数体、结构体/类/接口/枚举体后不加分号(} 即边界);模块级声明(导入/顶层常量/静态/全局变量)须分号。

主.cnCN

结构体 点 {
    整32 x;
    整32 y;
}

函数 主() -> 整32 {
    变量 a = 1;
    如果 a == 1 { 变量 t = 5; a = t; }
    打印("a: ", a);
    返回 0;
}

输出:a: 5

裸分号.cn(负例·编译拒绝)CN

函数 主() -> 整32 {
    ;                     // ✗ 空语句不合法
    返回 0;
}

当后分号.cn(负例·编译拒绝)CN

函数 主() -> 整32 {
    整32 x = 5;
    当(x > 10);           // ✗ 循环体强制 { }
    返回 0;
}

条件编译(#定义 / #如果定义)

编译期开关:以宏旗标在词法层裁剪源码分支——被裁分支不产生任何 token。宏是无值旗标;没有带参宏、宏体展开与 #包含(这些职责由模块系统与常量表达式承担)。

指令形态说明
#定义 宏名整行(行首可缩进)定义宏(无值旗标·仅存在性判定);父层被裁剪时不生效
#如果定义(宏名) 或 #如果定义 宏名整行条件开始:括号形式与空白形式等价
#否则整行条件分支(每层至多一个)
#结束如果整行条件结束(与 #如果定义 严格配对;纯空分支合法)
词法层裁剪模型非选中分支的整行在词法层被替换为空白(行号与换行保留)——不产生任何 token,即使内含语法错误也不诊断。宏名由 ASCII 字母/数字/下划线或中文组成。

主.cnCN

#定义 发布模式

函数 主() -> 整32 {
    // ---- 1. 源码内 #定义 宏 + #如果定义 选择 ----
    #如果定义 发布模式
    打印("发布模式: 开启");
    #否则
    打印("发布模式: 关闭")
    #结束如果

    // ---- 2. 未定义宏分支裁剪:语法错误代码被裁剪不应报错 ----
    #如果定义 不存在的宏
    这行是非法语法,不应被解析
    #否则
    打印("未定义宏分支: 已裁剪");
    #结束如果

    // ---- 3. 嵌套条件编译 ----
    #如果定义 发布模式
    打印("外层: 真");
    #如果定义 调试模式
    打印("内层: 调试")
    #否则
    打印("内层: 非调试");
    #结束如果
    #否则
    打印("外层: 假")
    #结束如果

    // ---- 4. 空宏名占位(宏未定义时的 #结束如果 正确闭合)----
    #如果定义 调试模式
    #结束如果
    打印("空分支: 已闭合");

    // ---- 5. 括号形式与空白形式等价 ----
    #如果定义(发布模式)
    打印("括号形式: 命中");
    #结束如果
    #如果定义 发布模式
    打印("空白形式: 命中");
    #结束如果

    返回 0;
}

输出:发布模式: 开启 未定义宏分支: 已裁剪 外层: 真 内层: 非调试 空分支: 已闭合 括号形式: 命中 空白形式: 命中

  • 嵌套:条件块可嵌套(上例第 3 段)——父层被裁剪时,内层 #定义 不生效、内层 #如果定义 恒假(C 语义)。
  • 上游注入:命令行 -D 宏名(可多次)与货舱.toml [特性] 的启用名单并入同一宏集合,等价源内 #定义——见命令行参考·选项、模块系统·货舱。
  • 行尾无关性:裁剪与源文件行尾格式(CRLF/LF)无关,两种行尾形态编译产物一致。
  • 不支持:带参宏、宏体展开、#包含、#取消定义、常量表达式条件——与 C 预处理器的能力边界划清。

未闭合条件编译.cn(负例·编译拒绝)CN

函数 主() -> 整32 {
    #如果定义 未闭合宏
    打印行("无结束如果");
    返回 0;
}