docs: README/CHANGELOG/语言参考更新至 v0.6
This commit is contained in:
@@ -1,5 +1,22 @@
|
||||
# Changelog
|
||||
|
||||
## 0.6.0 (2026-06-05)
|
||||
|
||||
### Added
|
||||
- 新类型: `i32` (32位有符号整数), `u64` (64位无符号整数), `char` (单字符) + 字符字面量 `'A'`
|
||||
- guard 语句: `guard x >= 0 else { return -1; }` (parser 去糖为 if-else)
|
||||
- 命名参数: `draw_rect(width: 10, height: 20)` 任意顺序传参，sema 重排序
|
||||
- 管道 `|>`: `10 |> double() |> add(5)` → `add(double(10), 5)` (F#/Elixir 风格)
|
||||
- 字符串插值: `"Hello, \(name)!"` → `"Hello, " + name + "!"` (Swift 风格)
|
||||
- 4 个新集成测试: 25_new_types ~ 29_interp
|
||||
|
||||
### Changed
|
||||
- **语法差异化**: `let mut` → `var`, `[T; N]` → `T[N]`, `..` → `to`, `impl` → `extend`
|
||||
- 类型隐式转换: `can_implicit_convert()` 加宽规则 + codegen `coerce_int()`
|
||||
- 符号表扩展: `Symbol.param_names` 支持命名参数匹配
|
||||
- AST 扩展: `CALL_EXPR`/`METHOD_CALL` 增加 `arg_names` 字段
|
||||
- 测试: 158 单元 (41+15+74+28) + 29 集成
|
||||
|
||||
## 0.5.0 (2026-06-05)
|
||||
|
||||
### Added
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<img src="https://img.shields.io/badge/version-0.5.0-blue" alt="version">
|
||||
<img src="https://img.shields.io/badge/version-0.6.0-blue" alt="version">
|
||||
<img src="https://img.shields.io/badge/C-17-555555" alt="C">
|
||||
<img src="https://img.shields.io/badge/LLVM-22.1.7-4B8BBE" alt="LLVM">
|
||||
<img src="https://img.shields.io/badge/GCC-15.x-darkgreen" alt="GCC">
|
||||
@@ -16,18 +16,20 @@
|
||||
|
||||
## 简介
|
||||
|
||||
L Language 是一门学习型编译语言，手写词法分析、递归下降 + Pratt 解析、语义分析和 LLVM IR 代码生成，最终生成原生可执行文件。语法借鉴 Rust，类型系统支持类型推断。
|
||||
L Language 是一门学习型编译语言，手写词法分析、递归下降 + Pratt 解析、语义分析和 LLVM IR 代码生成，最终生成原生可执行文件。语法博采众长（Rust/Swift/Elixir），拥有管道、字符串插值、命名参数等独有特性。
|
||||
|
||||
📖 **[语言参考手册](docs/language-reference.md)** — 完整的语法、类型、示例教程
|
||||
|
||||
```rust
|
||||
fn fib(n: i64) -> i64 {
|
||||
if n < 2 { return n; }
|
||||
return fib(n - 1) + fib(n - 2);
|
||||
fn double(x: i64) -> i64 {
|
||||
return x * 2;
|
||||
}
|
||||
|
||||
fn main() -> i64 {
|
||||
print_i64(fib(10)); // 输出 55
|
||||
let name = "L";
|
||||
print_str("Hello, \(name)!"); // 字符串插值
|
||||
let result = 10 |> double() |> double(); // 管道
|
||||
print_i64(result); // 40
|
||||
return 0;
|
||||
}
|
||||
```
|
||||
@@ -41,8 +43,8 @@ fn main() -> i64 {
|
||||
```mermaid
|
||||
graph TB
|
||||
subgraph 前端["编译器前端"]
|
||||
Lexer[词法分析器<br/>手写状态机<br/>40 种 Token]
|
||||
Parser[语法分析器<br/>递归下降 + Pratt<br/>14 种 AST 节点]
|
||||
Lexer[词法分析器<br/>手写状态机<br/>55+ 种 Token]
|
||||
Parser[语法分析器<br/>递归下降 + Pratt<br/>25 种 AST 节点]
|
||||
Sema[语义分析器<br/>作用域链 + 类型推断<br/>类型检查 + 错误收集]
|
||||
end
|
||||
|
||||
@@ -69,13 +71,13 @@ graph TB
|
||||
| 模块 | 输入 | 输出 | 核心结构 |
|
||||
|------|------|------|----------|
|
||||
| `lexer/` | `char*` 源码 | `Token[]` | `Token` {kind, start, length, line, col} |
|
||||
| `parser/` | `Token[]` | `AstNode*` | 14 种节点 (Program..IdentExpr) |
|
||||
| `parser/` | `Token[]` | `AstNode*` | 25 种节点 (Program..MethodCall) |
|
||||
| `ast/` | — | 工厂函数 | `AstNode` {kind, type, as{union}} |
|
||||
| `sema/` | `AstNode*` | 类型标注 | `Scope` 作用域链 + `Symbol` 符号表 |
|
||||
| `codegen/` | `AstNode*` | `LLVMModuleRef` | `CgCtx` {module, builder, var_table} |
|
||||
| `driver/` | 命令行参数 | exit code | 流水线串联 + 错误报告 |
|
||||
|
||||
## 功能 (v0.5)
|
||||
## 功能 (v0.6)
|
||||
|
||||
### 类型系统
|
||||
|
||||
@@ -103,6 +105,7 @@ graph TB
|
||||
- `while` 循环
|
||||
- `for i in 0 to 10` (去糖为 while)
|
||||
- `match expr { pat => { ... } _ => { ... } }` (去糖为 if-else)
|
||||
- `guard x >= 0 else { return -1; }` (去糖为 if-else)
|
||||
- `return`
|
||||
|
||||
### 函数 & 方法
|
||||
@@ -111,11 +114,15 @@ graph TB
|
||||
- 返回类型校验
|
||||
- `extend StructName { fn method(self: Type) -> Ret { ... } }`
|
||||
- `instance.method(args)` 调用
|
||||
- **命名参数**：`draw_rect(width: 10, height: 20)` 任意顺序传参
|
||||
- **管道 `|>`**：`10 |> double() |> add(5)` 数据流从左到右
|
||||
- 内建函数：`print_i64`, `print_f64`, `print_bool`, `print_str`
|
||||
|
||||
### 运算符
|
||||
### 运算符 & 语法糖
|
||||
|
||||
`+ - * / %` `== != < > <= >=` `&& || !` `+= -= *= /=` `str + str`
|
||||
`+ - * / %` `== != < > <= >=` `&& || !` `+= -= *= /=` `|>` `str + str`
|
||||
|
||||
- **字符串插值**：`"Hello, \(name)!"` → `"Hello, " + name + "!"`
|
||||
|
||||
### 内存管理
|
||||
|
||||
@@ -159,7 +166,7 @@ mingw32-make -j4
|
||||
# 构建
|
||||
cd build && mingw32-make -j4
|
||||
|
||||
# 运行全部测试 (158 单元 + 24 集成)
|
||||
# 运行全部测试 (158 单元 + 29 集成)
|
||||
./l_lang_lexer_test.exe # 词法分析 (41 tests)
|
||||
./l_lang_test.exe # 语法分析 (15 tests)
|
||||
./l_lang_sema_test.exe # 语义分析 (74 tests)
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# L Language 语言参考手册
|
||||
|
||||
> 版本 v0.5 | 158 测试全部通过 | LLVM 后端编译型语言
|
||||
> 版本 v0.6 | 158 单元 + 29 集成测试全部通过 | LLVM 后端编译型语言
|
||||
|
||||
---
|
||||
|
||||
@@ -54,9 +54,12 @@ l_lang.exe hello.l -o hello.exe
|
||||
|
||||
| 类型 | 关键字 | 范围/说明 | 示例 |
|
||||
|------|--------|----------|------|
|
||||
| 整数 | `i64` | 64位有符号，`-2^63 ~ 2^63-1` | `42`, `-7`, `0` |
|
||||
| 32位整数 | `i32` | 32位有符号，`-2^31 ~ 2^31-1` | `100` |
|
||||
| 64位整数 | `i64` | 64位有符号，`-2^63 ~ 2^63-1` | `42`, `-7`, `0` |
|
||||
| 无符号整数 | `u64` | 64位无符号，`0 ~ 2^64-1` | `999` |
|
||||
| 浮点 | `f64` | 64位双精度 | `3.14`, `-0.5`, `1.0` |
|
||||
| 布尔 | `bool` | `true` 或 `false` | `true`, `false` |
|
||||
| 字符 | `char` | 单字符，ASCII | `'A'`, `'\n'` |
|
||||
| 字符串 | `str` | UTF-8 文本 | `"Hello"`, `"你好"` |
|
||||
| 空类型 | `void` | 无返回值 | 用于函数返回类型 |
|
||||
|
||||
@@ -242,6 +245,67 @@ let result = add(3, 5);
|
||||
greet();
|
||||
```
|
||||
|
||||
### 命名参数
|
||||
|
||||
调用函数时可以标注参数名，命名参数可任意顺序，但必须放在位置参数之后：
|
||||
|
||||
```rust
|
||||
fn draw_rect(x: i64, y: i64, w: i64, h: i64) -> void {
|
||||
// ...
|
||||
}
|
||||
|
||||
draw_rect(0, 0, 100, 200); // 全位置
|
||||
draw_rect(x: 1, y: 2, w: 10, h: 20); // 全命名
|
||||
draw_rect(0, 0, w: 10, h: 20); // 混用
|
||||
draw_rect(w: 10, h: 20, x: 1, y: 2); // 命名任意顺序
|
||||
```
|
||||
|
||||
用 `:` 分隔参数名和值（与类型标注 `name: Type` 视觉统一）。
|
||||
|
||||
### guard 语句
|
||||
|
||||
guard 是提前返回的语法糖，用于提前处理异常条件：
|
||||
|
||||
```rust
|
||||
fn abs(x: i64) -> i64 {
|
||||
guard x >= 0 else { return -x; }
|
||||
return x;
|
||||
}
|
||||
// guard x >= 0 else { ... } 去糖为:
|
||||
// if !(x >= 0) { ... }
|
||||
```
|
||||
|
||||
- `else` 块必须用花括号，通常包含 `return`/`continue` 等跳转
|
||||
- guard 让正常路径的代码保持在左侧，提高可读性
|
||||
|
||||
### 管道 `|>`
|
||||
|
||||
管道将数据从左到右流经函数，LHS 作为 RHS 函数调用的第一个参数（F#/Elixir 风格）：
|
||||
|
||||
```rust
|
||||
fn double(x: i64) -> i64 { return x * 2; }
|
||||
fn add(a: i64, b: i64) -> i64 { return a + b; }
|
||||
|
||||
let result = 10 |> double() |> add(5);
|
||||
// 去糖为: add(double(10), 5) → 25
|
||||
```
|
||||
|
||||
- 管道右侧必须是函数调用（带括号）
|
||||
- 管道优先级低于所有算术运算符
|
||||
|
||||
### 字符串插值
|
||||
|
||||
用 `\(expr)` 在字符串中嵌入表达式（Swift 风格，`\` 与 C 转义字符视觉一致）：
|
||||
|
||||
```rust
|
||||
let name = "World";
|
||||
let msg = "Hello, \(name)!";
|
||||
print_str(msg); // Hello, World!
|
||||
```
|
||||
|
||||
- 去糖为字符串拼接: `"Hello, " + name + "!"`
|
||||
- 字面量 `\(` 写作 `\\(`，反斜杠写作 `\\`
|
||||
|
||||
---
|
||||
|
||||
## 7. 结构体
|
||||
@@ -563,15 +627,17 @@ l_lang.exe source.l --emit-ir
|
||||
## 快速参考卡片
|
||||
|
||||
```
|
||||
类型: i64 f64 bool str void struct enum T[N]
|
||||
类型: i32 i64 u64 f64 bool char str void struct enum T[N]
|
||||
声明: let x = val var x = val
|
||||
let x: Type = val type Alias = Type
|
||||
控制流: if/else while for i in 0 to N match
|
||||
控制流: if/else while for i in 0 to N match guard
|
||||
函数: fn name(p: T) -> Ret { return expr; }
|
||||
func(name: val) 命名参数 expr |> func() 管道
|
||||
结构体: struct Name { f: Type } Name { f: val }
|
||||
枚举: enum Name { A, B, C } Name::B
|
||||
方法: extend T { fn m(self: T) } obj.m()
|
||||
内建: print_i64 print_f64 print_bool print_str
|
||||
运算符: + - * / % == != < > <= >= && || ! += -= *= /=
|
||||
运算符: + - * / % == != < > <= >= && || ! += -= *= /= |>
|
||||
插值: "Hello, \(name)!"
|
||||
注释: // 行注释 /* 块注释 */
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user