CMLeonOS/Branswe.md

Branswe编程语言使用指南

简介

Branswe是一种简单的编程语言，用于CMLeonOS系统中进行脚本编写和自动化操作。它提供了基本的控制台操作、变量管理、条件判断、循环、文件系统操作等功能。

基本语法

命令格式

命令名 [参数]

注释

# 这是注释

变量操作

定义文本变量

var(text) 变量名 = 值

变量赋值

var() 变量名 = 变量2

变量删除

var() 变量名 rm

变量运算

var() 变量名 =+ 变量2
var() 变量名 =- 变量2
var() 变量名 =* 变量2
var() 变量名 =/ 变量2

获取变量值

ref getvar 变量名

控制台操作

显示文本（不换行）

conshow 变量名

显示文本（换行）

conshowl 变量名

清屏

concls

输入

coninput 变量名

蜂鸣

conbeep

系统引用

鼠标位置

ref mousex
ref mousey

屏幕尺寸

ref screenx
ref screeny

控制台颜色

ref concolour-b
ref concolour-f

磁盘信息

ref getalldisks

条件判断

decide语句

decide 变量1 操作符 变量2

支持的操作符：

• == 等于
• != 不等于
• > 大于
• < 小于
• >= 大于等于
• <= 小于等于

if语句

if 条件 then 真代码 else 假代码

示例

var(text) num1 = 10
var(text) num2 = 20
decide num1 == num2
if [] then conshow match else conshow no match

循环

loop语句

loop << 变量名

执行变量中的代码，无限循环。

示例

var(text) code = conshow hello
loop << code

字符串操作

读取字符串并执行

rstr 变量名

执行变量中存储的代码（支持\n换行）。

示例

var(text) mycode = conshow hello\nconshow world
rstr mycode

文件系统操作

注册VFS

diskfile reg

创建文件

diskfile create file 路径

创建目录

diskfile create dir 路径

写入文件

diskfile write 内容 to 路径

示例

diskfile reg
diskfile create file /test.txt
var(text) content = Hello, World!
diskfile write content to /test.txt

系统功能

睡眠

sleep 变量名

电源管理

power off
power reboot

结束程序

end

方法定义

定义方法

method 变量部分 << 代码部分

调用方法

方法名 参数

示例

var(text) printname = print
var(text) myname = Leon
method printname [] << conshow []
printname myname

完整示例

示例1：Hello World

# 简单的Hello World程序
var(text) hello = Hello, Branswe!
conshow hello

示例2：变量操作

# 变量定义和运算
var(text) num1 = 10
var(text) num2 = 20
var() num1 =+ num2
conshowl num1

示例3：条件判断

# 条件判断示例
var(text) a = 10
var(text) b = 20
decide a < b
if [] then conshow a is smaller else conshow a is larger

示例4：循环

# 循环示例
var(text) code = conshow loop\nsleep 1000
loop << code

示例5：文件操作

# 文件操作示例
diskfile reg
diskfile create file /test.txt
var(text) content = Hello, File System!
diskfile write content to /test.txt

示例6：系统功能

# 系统功能示例
conbeep
var(text) wait = 1000
sleep wait
ref mousex
conshowl []

示例7：自定义方法

# 自定义方法示例
var(text) greet = greet
var(text) name = Leon
method greet [] << conshow Hello, []!
greet name

注意事项

1. 大小写敏感：命令和变量名区分大小写
2. 空格处理：参数之间用空格分隔
3. 变量存储：所有变量都作为文本存储，运算时会自动转换
4. 注释支持：使用#号添加注释
5. 变量作用域：变量在整个脚本中有效
6. 无限循环：loop命令会无限循环，需要使用end或其他方式退出
7. 文件系统：使用diskfile前需要先执行diskfile reg注册VFS

最佳实践

1. 添加注释：在复杂逻辑前添加注释说明
2. 使用变量：避免硬编码，使用变量提高灵活性
3. 错误检查：在使用变量前检查其值
4. 代码格式：保持代码缩进和格式一致
5. 测试验证：逐步测试每个功能确保正确性

参考资料

• CMLeonOS Shell命令
• Branswe编程语言规范
• Cosmos系统文档

更新日志

版本2.0

• 更新了所有命令的实际语法
• 添加了文件系统操作支持
• 添加了系统引用命令
• 添加了电源管理功能
• 添加了自定义方法功能
• 修正了条件判断和循环的语法
• 完善了变量操作命令

版本1.0

• 初始版本
• 添加了CMLeonOS兼容性支持
• 完善了错误处理