@mirascript/help 0.1.40

package/src/operator/logical_and.md

@@ -0,0 +1,9 @@
+---
+token: '&&'
+---
+
+`&&` 是短路逻辑与，操作数必须是 `boolean`。
+
+```mira
+false && (1 / 0); // 右侧不会被求值
+```

package/src/operator/logical_and_assign.md

@@ -0,0 +1,11 @@
+---
+token: '&&='
+---
+
+`&&=` 是短路复合赋值，只有当左侧为 `true` 时才会计算并赋值右侧。
+
+```mira
+let mut b = true;
+b &&= false;
+// b == false
+```

package/src/operator/logical_or.md

@@ -0,0 +1,9 @@
+---
+token: '||'
+---
+
+`||` 是短路逻辑或，操作数必须是 `boolean`。
+
+```mira
+true || (1 / 0); // 右侧不会被求值
+```

package/src/operator/logical_or_assign.md

@@ -0,0 +1,11 @@
+---
+token: '||='
+---
+
+`||=` 是短路复合赋值，只有当左侧为 `false` 时才会计算并赋值右侧。
+
+```mira
+let mut b = false;
+b ||= true;
+// b == true
+```

package/src/operator/minus.md

@@ -0,0 +1,10 @@
+---
+token: '-'
+---
+
+`-` 用于减法（中缀）或一元负号（前缀）。
+
+```mira
+5 - 2; // 3
+-1;    // -1
+```

package/src/operator/minus_assign.md

@@ -0,0 +1,11 @@
+---
+token: '-='
+---
+
+`-=` 是复合赋值，`x -= y` 等价于 `x = x - y`。
+
+```mira
+let mut x = 3;
+x -= 1;
+// x == 2
+```

package/src/operator/not_equal.md

@@ -0,0 +1,10 @@
+---
+token: '!='
+---
+
+`!=` 判断两个值是否不相等，等价于 `!(x == y)`。
+
+```mira
+1 != 2; // true
+1 != 1; // false
+```

package/src/operator/null_coalescing.md

@@ -0,0 +1,10 @@
+---
+token: '??'
+---
+
+`??` 是空合并，当左侧为 `nil` 时返回右侧，否则返回左侧。
+
+```mira
+nil ?? 1; // 1
+0 ?? 1;   // 0
+```

package/src/operator/null_coalescing_assign.md

@@ -0,0 +1,14 @@
+---
+token: '??='
+---
+
+`??=` 是空合并复合赋值，仅当左侧为 `nil` 时才会赋值右侧。
+
+```mira
+let mut n = nil;
+n ??= 5;
+// n == 5
+
+n ??= 10;
+// n 仍然是 5
+```

package/src/operator/paren.md

@@ -0,0 +1,39 @@
+---
+token: ['(', ')']
+---
+
+`( )` 用于分组表达式、函数调用参数列表，以及记录字面量。
+
+---
+
+分组表达式，控制计算顺序：
+
+```mira
+let result = (1 + 2) * 3; // 先计算 1 + 2，然后乘以 3
+```
+
+---
+
+函数声明和调用：
+
+```mira
+fn add(a, b) { a + b }
+let sum = add(1, 2);
+```
+
+---
+
+记录字面量：
+
+```mira
+let record = (a: 1, b: 2);
+let empty = (); // 空记录
+```
+
+---
+
+对于省略键名的单元素记录，必须添加逗号以区别于分组表达式。
+
+```mira
+let single = (1,)
+```

package/src/operator/percent.md

@@ -0,0 +1,9 @@
+---
+token: '%'
+---
+
+`%` 用于取余。
+
+```mira
+5 % 2; // 1
+```

package/src/operator/percent_assign.md

@@ -0,0 +1,11 @@
+---
+token: '%='
+---
+
+`%=` 是复合赋值：`x %= y` 等价于 `x = x % y`。
+
+```mira
+let mut x = 5;
+x %= 2;
+// x == 1
+```

package/src/operator/plus.md

@@ -0,0 +1,10 @@
+---
+token: '+'
+---
+
+`+` 用于加法（中缀）或一元正号（前缀）。
+
+```mira
+1 + 2; // 3
++1;    // 1
+```

package/src/operator/plus_assign.md

@@ -0,0 +1,11 @@
+---
+token: '+='
+---
+
+`+=` 是复合赋值，`x += y` 等价于 `x = x + y`。
+
+```mira
+let mut x = 1;
+x += 2;
+// x == 3
+```

package/src/operator/question.md

@@ -0,0 +1,9 @@
+---
+token: '?'
+---
+
+`?` 用于条件表达式（三元表达式）：`cond ? thenExpr : elseExpr`。
+
+```mira
+fn sign { it > 0 ? 1 : it < 0 ? -1 : 0 }
+```

package/src/operator/question_colon.md

@@ -0,0 +1,12 @@
+---
+token: '?:'
+---
+
+`?:` 用于记录字面量的“可选字段”，当值为 `nil` 时省略该字段。
+
+```mira
+(a?: 1, b?: nil); // (a: 1)
+
+// 省略不会删除已经通过展开引入的同名字段
+(..(a: 1), a?: nil); // (a: 1)
+```

package/src/operator/semicolon.md

@@ -0,0 +1,13 @@
+---
+token: ';'
+---
+
+`;` 用于结束语句。MiraScript 以表达式为主，但在多语句块中常用 `;` 分隔。
+
+```mira
+let sum = {
+  let x = 1;
+  let y = 2;
+  x + y
+};
+```

package/src/operator/slash.md

@@ -0,0 +1,9 @@
+---
+token: '/'
+---
+
+`/` 用于除法。
+
+```mira
+6 / 3; // 2
+```

package/src/operator/slash_assign.md

@@ -0,0 +1,11 @@
+---
+token: '/='
+---
+
+`/=` 是复合赋值，`x /= y` 等价于 `x = x / y`。
+
+```mira
+let mut x = 6;
+x /= 3;
+// x == 2
+```

package/src/operator/spread_range.md

@@ -0,0 +1,31 @@
+---
+token: '..'
+---
+
+`..` 表示闭区间范围，或在数组/记录字面量及函数调用中表示展开。
+
+---
+
+表示数组字面量、切片和循环的范围：
+
+```mira
+let arr = [1..3]; // arr = [1, 2, 3]
+let slice = arr[0..1]; // slice = [1, 2]
+
+for i in 1..3 {
+  // i 依次为 1, 2, 3
+}
+```
+
+---
+
+展开数组/记录或函数调用：
+
+```mira
+let arr = [1, ..[2, 3]]; // arr = [1, 2, 3]
+let rec1 = (a: 1, ..(b: 2, c: 3)); // rec1 = (a: 1, b: 2, c: 3)
+// 同名键以最后一个为准
+let rec2 = (..(1, 2), ..(3, 4, 5)); // rec2 = (0: 3, 1: 4, 2: 5)
+
+let result = sum(..[1, 2, 3]); // 等同于 sum(1, 2, 3)
+```

package/src/operator/tilde_equal.md

@@ -0,0 +1,24 @@
+---
+token: '=~'
+---
+
+`=~` 是“近似相等”，用于数值容差比较和字符串归一化比较。
+
+---
+
+对于 `number` 类型，当两个操作数的相对误差**或**绝对误差小于 `1e-15` 时，返回 `true`，否则返回 `false`。
+
+如果其中一个操作数为 `number` 类型，另一个操作数在比较前也会自动转换为 `number` 类型。
+
+```mira
+0.1 + 0.2 =~ 0.3; // true
+1 =~ "1";        // true
+```
+
+---
+
+对于 `string` 类型，`=~` 运算符进行大小写不敏感的[正规化（NFC）](https://unicode.org/reports/tr15/)比较。
+
+```mira
+"café" =~ "CAFÉ"; // true
+```

package/src/operator/tilde_not_equal.md

@@ -0,0 +1,10 @@
+---
+token: '!~'
+---
+
+`!~` 是 `=~` 的否定形式（不近似相等）。
+
+```mira
+1 !~ 2;     // true
+"a" !~ "A"; // false
+```