octave_toml11文档

欢迎广大开发者将此文档翻译为其他语言。

用户须知：toml11会导致很多segfault（段错误），而且不稳定，因此octave_toml11也是这样。对于octave_toml11给用户带来的不便，作者深表歉意，并表示如果以后有更好用的toml库，作者将弃用此软件包。

软件源安装

octave_toml11可以通过Octave软件源安装。

通过Octave软件源安装octave_toml11，代码如下：

>> pkg install -forge octave_toml11

在线安装

octave_toml11可以在线安装。

在线安装octave_toml11，代码如下：

>> pkg install 'https://github.com/CNOCTAVE/octave_toml11/releases/download/0.1.0/octave_toml11.tar.gz'

源码安装

octave_toml11可以直接使用tar包安装。

假设你下载的源码包名为octave_toml11.tar.gz，源码安装的代码如下：

>> pkg install octave_toml11.tar.gz -local

如何使用

在安装后，加载octave_toml11即可使用，代码如下：

>> pkg load octave_toml11

依赖库

不同的Linux发行版有不同的依赖库名。

Fedora：

$ sudo dnf install libtoml11-devel

在其他的Linux发行版上的命令有所不同。欢迎广大开发者补充。

函数用法

toml_find_by_idx

Loadable Function: OV = toml_find_by_idx(TOML_DATA, IDX)

Loadable Function: OV = toml_find_by_idx(TOML_DATA, IDX, SEMVER)

输入TOML字符串TOML_DATA和下标IDX，可选输入版本号SEMVER。

返回下标IDX处的数据OV。

默认版本号为[1, 0, 0]（即TOML 1.0.0）。

版本号是一个三元矩阵。

如果版本号大于等于TOML 1.1.0，则支持TOML 1.1.0的特性。

toml_find_by_key

Loadable Function: OV = toml_find_by_key(TOML_DATA, KEY)

Loadable Function: OV = toml_find_by_key(TOML_DATA, KEY, SEMVER)

输入TOML字符串TOML_DATA和键KEY，可选输入版本号SEMVER。

返回键KEY处的数据OV。

默认版本号为[1, 0, 0]（即TOML 1.0.0）。

版本号是一个三元矩阵。

如果版本号大于等于TOML 1.1.0，则支持TOML 1.1.0的特性。

toml_format

Loadable Function: OV = toml_format(TOML_DATA)

Loadable Function: OV = toml_format(TOML_DATA, SEMVER)

输入TOML字符串TOML_DATA，可选输入版本号SEMVER。

返回格式化之后的数据OV。

默认版本号为[1, 0, 0]（即TOML 1.0.0）。

版本号是一个三元矩阵。

如果版本号大于等于TOML 1.1.0，则支持TOML 1.1.0的特性。

toml_isa

Loadable Function: OV = toml_isa(TOML_DATA, KEY, TYPE)

Loadable Function: OV = toml_isa(TOML_DATA, KEY, TYPE, SEMVER)

输入TOML字符串TOML_DATA，键KEY和类型TYPE，可选输入版本号SEMVER。

判断键KEY处的数据是否属于类型TYPE（返回true或false）。

支持判断的类型如下：

类型含义

empty 判断键KEY处的数据是否为空

boolean 判断键KEY处的数据是否属于类型boolean

integer 判断键KEY处的数据是否属于类型integer

floating 判断键KEY处的数据是否属于类型float

string 判断键KEY处的数据是否属于类型string

offset_datetime 判断键KEY处的数据是否属于类型offset datetime

local_datetime 判断键KEY处的数据是否属于类型local datetime

local_date 判断键KEY处的数据是否属于类型local date

local_time 判断键KEY处的数据是否属于类型local time

array 判断键KEY处的数据是否属于类型array

table 判断键KEY处的数据是否属于类型table

默认版本号为[1, 0, 0]（即TOML 1.0.0）。

版本号是一个三元矩阵。

如果版本号大于等于TOML 1.1.0，则支持TOML 1.1.0的特性。

TOML示例

>> toml = '[a]\nname="A"\n[a.b]\nname="B"\n[a.b.c]\nname="C"\n[a.b.c.d]\nname="D"';

常见用例

返回下标2处的数据，代码如下：

>> ov = toml_find_by_idx(a, 2);

返回键a处的数据，代码如下：

>> ov = toml_find_by_key(a, 'a');

格式化TOML，代码如下：

>> ov = toml_format(a);

判断键a处的数据是否属于类型table，代码如下：

>> ov = toml_isa(a, 'a', 'table');

引用octave_toml11

如果你在学术研究中涉及octave_toml11，那么可以按需引用以下内容。

octave_toml11源码(BibTeX)

@misc{CNOCTAVE2025, author = {Yu Hongbo, }, title = {octave_toml11}, year = {2025}, howpublished = {\url{https://github.com/CNOCTAVE/octave_toml11}}, }

octave_toml11文档(BibTeX)

@techreport{CNOCTAVE2025, author = {Yu Hongbo, }, title = {octave_toml11 Document}, institution = {BA DU XIN SHANG}, year = {2025}, number = {12}, month = {7}, url = {https://cnoctave.github.io/octave_toml11/index.html}, urldate = {2025-07-12}, }