- CHANGELOG.md:v2.8.0 条目(中英双语); - README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明); - doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制); - skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/ require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过); - 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
19 KiB
Executable File
markup, title, description
| markup | title | description |
|---|---|---|
| occlusion | lib/数学 | 高中数学 — 数值、随机、公式、作图 |
高中数学 — 数值、随机、公式、作图
计算数字、符号表达式和绘图。
能力与边界:number 契约包括符号公式;三角函数使用弧度。随机数需要 random.read,绘图具有输出效应。矩阵和量子计算保留在扩展库。
本文件就是调用和开发手册:直接导入此文件,或用 marqdo call 按下面的函数标题调用。参数表说明类型和默认值;未填默认值的参数必须提供。返回表是渐进契约,后文说明失败与边界。
实现入口:src/host/math.rs
开发时保持中英文语义一致,先组合公开库;仅在 OS 或算法边界添加宿主原语并声明效应。修改后运行 marqdo check --narrative-ratio 本文件,并执行 tests/stdlib_tasks.rs 的真实任务。
圆周率
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 返回数学常数圆周率 |
调用效应:pure。
返回数学常数圆周率。
完成后返回*返回数学常数圆周率*。
自然底数
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 返回自然常数 e |
调用效应:pure。
返回自然常数 e。
完成后返回*返回自然常数 e*。
数
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| value | any | 必填 | 运行时值;具体规则见下方操作说明 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 把数字或数字文本转换为数值 |
这里使用value。
调用效应:pure。
把数字或数字文本转换为数值。
完成后返回*[把数字或数字文本转换为数值](> host_num value=value)*。
加
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| a | any | 必填 | 第一个操作数;适用范围见本操作说明 |
| b | any | 必填 | 第二个操作数;适用范围见本操作说明 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 将两个数字或符号表达式相加 |
这里使用a、b。
调用效应:pure。
将两个数字或符号表达式相加。
完成后返回*[将两个数字或符号表达式相加](> host_math_add a=a b=b)*。
减
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| a | any | 必填 | 第一个操作数;适用范围见本操作说明 |
| b | any | 必填 | 第二个操作数;适用范围见本操作说明 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 从 a 减去 b |
这里使用a、b。
调用效应:pure。
从 a 减去 b。
完成后返回*[从 a 减去 b](> host_math_sub a=a b=b)*。
乘
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| a | any | 必填 | 第一个操作数;适用范围见本操作说明 |
| b | any | 必填 | 第二个操作数;适用范围见本操作说明 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 计算 a 与 b 的乘积 |
这里使用a、b。
调用效应:pure。
计算 a 与 b 的乘积。
完成后返回*[计算 a 与 b 的乘积](> host_math_mul a=a b=b)*。
除
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| a | any | 必填 | 第一个操作数;适用范围见本操作说明 |
| b | any | 必填 | 第二个操作数;适用范围见本操作说明 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 计算 a 除以 b;除数为零时报错 |
这里使用a、b。
调用效应:pure。
计算 a 除以 b;除数为零时报错。
完成后返回*[计算 a 除以 b;除数为零时报错](> host_math_div a=a b=b)*。
幂
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| a | any | 必填 | 第一个操作数;适用范围见本操作说明 |
| b | any | 必填 | 第二个操作数;适用范围见本操作说明 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 计算 a 的 b 次幂 |
这里使用a、b。
调用效应:pure。
计算 a 的 b 次幂。
完成后返回*[计算 a 的 b 次幂](> host_math_pow a=a b=b)*。
负
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| value | any | 必填 | 运行时值;具体规则见下方操作说明 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 对数字或符号值取负 |
这里使用value。
调用效应:pure。
对数字或符号值取负。
完成后返回*[对数字或符号值取负](> host_math_neg value=value)*。
正弦
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| value | any | 必填 | 运行时值;具体规则见下方操作说明 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 计算正弦;数值角度使用弧度 |
这里使用value。
调用效应:pure。
计算正弦;数值角度使用弧度。
完成后返回*[计算正弦;数值角度使用弧度](> host_math_sin value=value)*。
余弦
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| value | any | 必填 | 运行时值;具体规则见下方操作说明 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 计算余弦;数值角度使用弧度 |
这里使用value。
调用效应:pure。
计算余弦;数值角度使用弧度。
完成后返回*[计算余弦;数值角度使用弧度](> host_math_cos value=value)*。
正切
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| value | any | 必填 | 运行时值;具体规则见下方操作说明 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 计算正切;数值角度使用弧度 |
这里使用value。
调用效应:pure。
计算正切;数值角度使用弧度。
完成后返回*[计算正切;数值角度使用弧度](> host_math_tan value=value)*。
反正弦
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| value | any | 必填 | 运行时值;具体规则见下方操作说明 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 计算反正弦,结果为弧度 |
这里使用value。
调用效应:pure。
计算反正弦,结果为弧度。
完成后返回*[计算反正弦,结果为弧度](> host_math_asin value=value)*。
反余弦
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| value | any | 必填 | 运行时值;具体规则见下方操作说明 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 计算反余弦,结果为弧度 |
这里使用value。
调用效应:pure。
计算反余弦,结果为弧度。
完成后返回*[计算反余弦,结果为弧度](> host_math_acos value=value)*。
反正切
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| value | any | 必填 | 运行时值;具体规则见下方操作说明 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 计算反正切,结果为弧度 |
这里使用value。
调用效应:pure。
计算反正切,结果为弧度。
完成后返回*[计算反正切,结果为弧度](> host_math_atan value=value)*。
平方根
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| value | any | 必填 | 运行时值;具体规则见下方操作说明 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 计算 value 的平方根 |
这里使用value。
调用效应:pure。
直接调用此函数:
marqdo call lib/数学.mq.md 平方根 value=9 --effects none --json
计算 value 的平方根。
完成后返回*[计算 value 的平方根](> host_math_sqrt value=value)*。
绝对值
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| value | any | 必填 | 运行时值;具体规则见下方操作说明 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 返回绝对值 |
这里使用value。
调用效应:pure。
返回绝对值。
完成后返回*[返回绝对值](> host_math_abs value=value)*。
对数
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| value | any | 必填 | 运行时值;具体规则见下方操作说明 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 计算自然对数 |
这里使用value。
调用效应:pure。
计算自然对数。
完成后返回*[计算自然对数](> host_math_ln value=value)*。
指数
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| value | any | 必填 | 运行时值;具体规则见下方操作说明 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 计算自然指数函数 |
这里使用value。
调用效应:pure。
计算自然指数函数。
完成后返回*[计算自然指数函数](> host_math_exp value=value)*。
向下取整
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| value | any | 必填 | 运行时值;具体规则见下方操作说明 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 向负无穷取整 |
这里使用value。
调用效应:pure。
向负无穷取整。
完成后返回*[向负无穷取整](> host_math_floor value=value)*。
向上取整
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| value | any | 必填 | 运行时值;具体规则见下方操作说明 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 向正无穷取整 |
这里使用value。
调用效应:pure。
向正无穷取整。
完成后返回*[向正无穷取整](> host_math_ceil value=value)*。
最小
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| a | any | 必填 | 第一个操作数;适用范围见本操作说明 |
| b | any | 必填 | 第二个操作数;适用范围见本操作说明 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 返回较小的操作数 |
这里使用a、b。
调用效应:pure。
返回较小的操作数。
完成后返回*[返回较小的操作数](> host_math_min a=a b=b)*。
最大
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| a | any | 必填 | 第一个操作数;适用范围见本操作说明 |
| b | any | 必填 | 第二个操作数;适用范围见本操作说明 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 返回较大的操作数 |
这里使用a、b。
调用效应:pure。
返回较大的操作数。
完成后返回*[返回较大的操作数](> host_math_max a=a b=b)*。
随机
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 返回伪随机数;可用种子控制复现 |
调用效应:random.read。
返回伪随机数;可用种子控制复现。
完成后返回*返回伪随机数;可用种子控制复现*。
随机整数
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| min | any | 必填 | 下界,或搜索与绘图区间的起点 |
| max | any | 必填 | 上界,或搜索与绘图区间的终点 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 在约定区间内返回伪随机整数 |
这里使用min、max。
调用效应:random.read。
在约定区间内返回伪随机整数。
完成后返回*[在约定区间内返回伪随机整数](> host_random_int min=min max=max)*。
设种子
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| value | any | 必填 | 运行时值;具体规则见下方操作说明 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | 设置本次运行的伪随机种子;不用于机密值 |
这里使用value。
调用效应:pure。
设置本次运行的伪随机种子;不用于机密值。
完成后返回*[设置本次运行的伪随机种子;不用于机密值](> host_seed value=value)*。
公式
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| text | text | 必填 | 调用方提供的文本 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 把表达式文本解析为符号公式,供后续代数运算或求值使用;语法无效时返回诊断 |
这里使用text。
调用效应:pure。
把表达式文本解析为符号公式,供后续代数运算或求值使用;语法无效时返回诊断。
完成后返回*[把表达式文本解析为符号公式,供后续代数运算或求值使用;语法无效时返回诊断](> host_formula value=text)*。
化简
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| formula | any | 必填 | 公式函数或前序符号运算返回的符号公式 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 返回化简后的公式并保留输入;这是符号代数运算,不是数值求值 |
这里使用formula。
调用效应:pure。
返回化简后的公式并保留输入;这是符号代数运算,不是数值求值。
完成后返回*[返回化简后的公式并保留输入;这是符号代数运算,不是数值求值](> host_simplify value=formula)*。
展开
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| formula | any | 必填 | 公式函数或前序符号运算返回的符号公式 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 展开代数乘积与幂,返回新的符号公式 |
这里使用formula。
调用效应:pure。
展开代数乘积与幂,返回新的符号公式。
完成后返回*[展开代数乘积与幂,返回新的符号公式](> host_expand value=formula)*。
求导
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| formula | any | 必填 | 公式函数或前序符号运算返回的符号公式 |
| var | any | 必填 | 求导、代入、求值或求根所针对的符号名 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 对指定符号求导并返回符号导函数 |
这里使用formula、var。
调用效应:pure。
对指定符号求导并返回符号导函数。
完成后返回*[对指定符号求导并返回符号导函数](> host_diff formula=formula var=var)*。
代入
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| formula | any | 必填 | 公式函数或前序符号运算返回的符号公式 |
| var | any | 必填 | 求导、代入、求值或求根所针对的符号名 |
| value | any | 必填 | 运行时值;具体规则见下方操作说明 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | 用指定值替换公式中的符号;完全化简时返回数字,否则保留公式 |
这里使用formula、var、value。
调用效应:pure。
用指定值替换公式中的符号;完全化简时返回数字,否则保留公式。
完成后返回*[用指定值替换公式中的符号;完全化简时返回数字,否则保留公式](> host_subs formula=formula var=var value=value)*。
求值
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| formula | any | 必填 | 公式函数或前序符号运算返回的符号公式 |
| var | any | 必填 | 求导、代入、求值或求根所针对的符号名 |
| value | any | 必填 | 运行时值;具体规则见下方操作说明 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | 在一个变量取指定数值时计算公式;仍有未绑定符号时返回诊断 |
这里使用formula、var、value。
调用效应:pure。
在一个变量取指定数值时计算公式;仍有未绑定符号时返回诊断。
完成后返回*[在一个变量取指定数值时计算公式;仍有未绑定符号时返回诊断](> host_eval formula=formula var=var value=value)*。
求解
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| formula | any | 必填 | 公式函数或前序符号运算返回的符号公式 |
| var | any | 必填 | 求导、代入、求值或求根所针对的符号名 |
| min | any | None | 下界,或搜索与绘图区间的起点 |
| max | any | None | 上界,或搜索与绘图区间的终点 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | 返回指定符号在上下界内的根列表;省略边界时使用 -100 到 100 |
这里使用formula、var、min=None、max=None。
调用效应:pure。
返回指定符号在上下界内的根列表;省略边界时使用 -100 到 100。
完成后返回*[返回指定符号在上下界内的根列表;省略边界时使用 -100 到 100](> host_solve formula=formula var=var min=min max=max)*。
绘图
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| formula | any | 必填 | 公式函数或前序符号运算返回的符号公式 |
| var | any | 必填 | 求导、代入、求值或求根所针对的符号名 |
| min | any | 必填 | 下界,或搜索与绘图区间的起点 |
| max | any | 必填 | 上界,或搜索与绘图区间的终点 |
| steps | any | None | 绘图区间内的采样数量 |
| path | any | None | 相对已授权文件根目录的路径 |
| derivative | any | None | 是否在图中包含导函数 |
| grid | any | None | 是否绘制坐标网格 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | 在区间内采样公式并返回 SVG 文本;指定路径时还会在授权根目录内写出 SVG |
这里使用formula、var、min、max、steps=None、path=None、derivative=None、grid=None。
调用效应:output.write。
在区间内采样公式并返回 SVG 文本;指定路径时还会在授权根目录内写出 SVG。
完成后返回*[在区间内采样公式并返回 SVG 文本;指定路径时还会在授权根目录内写出 SVG](> host_plot formula=formula var=var min=min max=max steps=steps path=path derivative=derivative grid=grid)*。
绘点列
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| xs | any | 必填 | 本操作要求的输入列表或集合 |
| ys | any | 必填 | 与 xs 一一对应的 Y 坐标列表 |
| path | any | None | 相对已授权文件根目录的路径 |
| grid | any | None | 是否绘制坐标网格 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | 将一一对应的横纵坐标列表绘成 SVG 文本;两列长度不等时拒绝绘制 |
这里使用xs、ys、path=None、grid=None。
调用效应:output.write。
将一一对应的横纵坐标列表绘成 SVG 文本;两列长度不等时拒绝绘制。
完成后返回*[将一一对应的横纵坐标列表绘成 SVG 文本;两列长度不等时拒绝绘制](> host_plot_points xs=xs ys=ys path=path grid=grid)*。
绘圆锥
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| kind | any | 必填 | 圆锥曲线绘制函数接受的曲线类型 |
| a | any | 必填 | 第一个操作数;适用范围见本操作说明 |
| b | any | None | 第二个操作数;适用范围见本操作说明 |
| h | any | None | 圆锥曲线中心的水平偏移 |
| k | any | None | 圆锥曲线中心的垂直偏移 |
| path | any | None | 相对已授权文件根目录的路径 |
| grid | any | None | 是否绘制坐标网格 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | 按曲线类型、尺寸和中心偏移绘制圆锥曲线,返回 SVG 文本 |
这里使用kind、a、b=None、h=None、k=None、path=None、grid=None。
调用效应:output.write。
按曲线类型、尺寸和中心偏移绘制圆锥曲线,返回 SVG 文本。
完成后返回*[按曲线类型、尺寸和中心偏移绘制圆锥曲线,返回 SVG 文本](> host_plot_conic kind=kind a=a b=b h=h k=k path=path grid=grid)*。