标准库概览

使用方式

标准库模块用 daoru "模块名" 导入，然后用 模块名.函数名(...) 调用：

拼音

daoru "wenjian"

rukou() {
    changshi {
        bl text = wenjian.du_wenben("config.txt")
        dayin(text)
    } buhuo (e) {
        dayin(e.xinxi)
    }
}

英文

import "fs"

rukou() {
    try {
        var text = fs.read_to_string("config.txt")
        print(text)
    } catch (e) {
        print(e.msg)
    }
}

• 标准库只能整个导入，不能写 daoru { du_wenben } laizi "wenjian"
• 字符串模块不用导入，直接使用
• 标准库的函数和模块名都有拼音名，没有中文名；本节的代码示例只有拼音和英文两种写法

拼音名

函数的拼音名和英文名完全等价。部分模块名也有拼音名，导入时用哪个名字，调用时就用哪个，两套名字不能混着用：

拼音

daoru "huanjing"

rukou() {
    dayin(huanjing.huoqu("HOME"))
}

英文

import "env"

rukou() {
    print(env.get("HOME"))
}

拼音	英文	说明
zifuchuan	string	字符串，不需要导入
—	io	标准输入输出
huanjing	env	环境变量
wenjian	fs	文件与目录
wangluo	net	TCP 网络
—	http	HTTP，协议名不翻译

模块名是保留的：不能用作变量名、函数名，本地文件也不能叫 io.cp、wenjian.cp。

模块一览

文本与输入输出

• 字符串（zifuchuan / string）：切分、拼接、修剪、替换、大小写转换
• 输入输出（io）：dayin 打印、读标准输入、写标准错误

系统

• 环境变量（huanjing / env）：读取、设置、删除环境变量
• 文件（wenjian / fs）：读写文件、目录操作、逐行读取

网络

• TCP（wangluo / net）：TCP 客户端与服务端
• HTTP 客户端（http）：发送 GET / POST 请求
• HTTP 服务端（http）：简单的 HTTP 服务

错误处理

可能失败的函数都标了 kecuo，要写在 changshi 里，见 fails / try / catch。各模块的错误码含义不同，请用模块提供的判断函数，不要直接比较数字：

拼音

daoru "wenjian"

rukou() {
    changshi {
        bl text = wenjian.du_wenben("config.txt")
    } buhuo (e) {
        ruguo (wenjian.shi_bu_cunzai(e.daima)) {
            dayin("配置文件不存在")
        }
    }
}

英文

import "fs"

rukou() {
    try {
        var text = fs.read_to_string("config.txt")
    } catch (e) {
        if (fs.is_not_found(e.code)) {
            print("配置文件不存在")
        }
    }
}