Initial commit: Oraset B-5 with C++ style features

website/docs/md/language.md

@@ -0,0 +1,212 @@
+# 语言参考
+
+Oraset 编程语言 B-5 版本的完整语法参考文档，包含变量、数据类型、运算符和控制流等核心特性。
+
+## 变量
+
+### 声明变量
+
+```oraset
+var x = 10;
+var name = "test";
+var pi = 3.14;
+var flag;
+```
+
+### 修改变量
+
+```oraset
+x = 20;
+name = "new name";
+```
+
+### 复合赋值
+
+```oraset
+x += 5;
+x -= 3;
+x *= 2;
+x /= 2;
+x %= 3;
+```
+
+### 自增自减
+
+```oraset
+x++;
+x--;
+```
+
+## 数据类型
+
+- **数字**：整数和浮点数，如 `42`、`3.14`
+- **字符串**：用双引号或单引号包围，如 `"Hello"`、`'World'`
+- **数组**：用方括号定义，如 `[1, 2, 3]`
+
+## 数组
+
+### 创建数组
+
+```oraset
+var arr = [10, 20, 30, 40, 50];
+var empty = array(5);
+```
+
+### 访问数组元素
+
+```oraset
+print(arr[0]);
+arr[2] = 35;
+```
+
+### 数组长度
+
+```oraset
+var len = arrlen(arr);
+```
+
+## 运算符
+
+### 算术运算符
+
+```oraset
++   // 加法
+-   // 减法
+*   // 乘法
+/   // 除法
+%   // 取模
+```
+
+### 比较运算符
+
+```oraset
+==  // 等于
+!=  // 不等于
+>   // 大于
+<   // 小于
+>=  // 大于等于
+<=  // 小于等于
+```
+
+### 逻辑运算符
+
+```oraset
+&&  // 逻辑与
+||  // 逻辑或
+!   // 逻辑非
+```
+
+## 输出
+
+### print 函数
+
+```oraset
+print("Hello");              // 输出并换行
+print("No newline", "nel");    // 输出不换行
+print("A", "B", 123);          // 多个参数用空格分隔
+print(arr);                    // 打印数组
+```
+
+## 控制流
+
+### 条件语句
+
+```oraset
+if (x > 10) {
+    print("x is big");
+} else {
+    print("x is small");
+}
+```
+
+### 循环语句
+
+```oraset
+while (x < 100) {
+    print(x);
+    x++;
+}
+
+for (var i = 0; i < 10; i++) {
+    print(i);
+}
+```
+
+### 函数定义
+
+```oraset
+function add(a, b) {
+    return a + b;
+}
+
+add(5, 3);
+```
+
+## 内置函数
+
+### 数学函数
+
+```oraset
+abs(x)       // 绝对值
+sqrt(x)      // 平方根
+sin(x)       // 正弦
+cos(x)       // 余弦
+tan(x)       // 正切
+pow(x, y)    // x的y次方
+log(x)       // 自然对数
+floor(x)     // 向下取整
+ceil(x)      // 向上取整
+round(x)     // 四舍五入
+int(x)       // 转为整数
+float(x)     // 转为浮点数
+rand()       // 0-1随机数
+rand(n)      // 0-n随机数
+time()       // 当前时间戳
+```
+
+### 字符串函数
+
+```oraset
+len(str)     // 字符串长度
+num(str)     // 字符串转数字
+str(num)     // 数字转字符串
+```
+
+### 数组函数
+
+```oraset
+array(size)  // 创建指定大小的数组
+arrlen(arr)  // 获取数组长度
+```
+
+### 输入函数
+
+```oraset
+input()           // 读取用户输入
+input("提示:")     // 带提示的输入
+```
+
+## 文件配置
+
+### sg 语法
+
+```oraset
+sg<nel>
+print("All lines no newline");
+print("Still same line");
+```
+
+`sg<nel>` 设置整个文件的 print 默认不换行。
+
+## 注释
+
+```oraset
+# 单行注释
+// 单行注释
+/* 多行
+   注释 */
+```
+
+---
+
+Oraset Project &copy; 2026