tomlc99
1.0.0
c99 中的 TOML；兼容 v1.0。
如果您正在寻找 C++ 库，您可以尝试这个包装器：https://github.com/cktan/tomlcpp。
详细信息请参阅toml.h文件。以下是解析此配置文件的简单示例：
[ server ]
host = " www.example.com "
port = [ 8080 , 8181 , 8282 ]以下是从文件中获取值的常见步骤：
下面是解析示例表中的值的示例。
#include <stdio.h>
#include <string.h>
#include <errno.h>
#include <stdlib.h>
#include "toml.h"
static void error ( const char * msg , const char * msg1 )
{
fprintf ( stderr , "ERROR: %s%sn" , msg , msg1 ? msg1 : "" );
exit ( 1 );
}
int main ()
{
FILE * fp ;
char errbuf [ 200 ];
// 1. Read and parse toml file
fp = fopen ( "sample.toml" , "r" );
if (! fp ) {
error ( "cannot open sample.toml - " , strerror ( errno ));
}
toml_table_t * conf = toml_parse_file ( fp , errbuf , sizeof ( errbuf ));
fclose ( fp );
if (! conf ) {
error ( "cannot parse - " , errbuf );
}
// 2. Traverse to a table.
toml_table_t * server = toml_table_in ( conf , "server" );
if (! server ) {
error ( "missing [server]" , "" );
}
// 3. Extract values
toml_datum_t host = toml_string_in ( server , "host" );
if (! host . ok ) {
error ( "cannot read server.host" , "" );
}
toml_array_t * portarray = toml_array_in ( server , "port" );
if (! portarray ) {
error ( "cannot read server.port" , "" );
}
printf ( "host: %sn" , host . u . s );
printf ( "port: " );
for ( int i = 0 ; ; i ++ ) {
toml_datum_t port = toml_int_at ( portarray , i );
if (! port . ok ) break ;
printf ( "%d " , ( int ) port . u . i );
}
printf ( "n" );
// 4. Free memory
free ( host . u . s );
toml_free ( conf );
return 0 ;
}TOML 表是使用字符串键进行查找的字典。一般来说，表上的所有访问函数都被命名为toml_*_in(...) 。
在正常情况下，您知道密钥及其内容类型，并且可以使用以下函数之一完成检索：
toml_string_in ( tab , key );
toml_bool_in ( tab , key );
toml_int_in ( tab , key );
toml_double_in ( tab , key );
toml_timestamp_in ( tab , key );
toml_table_in ( tab , key );
toml_array_in ( tab , key );您还可以使用整数索引查询表中的键：
toml_table_t * tab = toml_parse_file (...);
for ( int i = 0 ; ; i ++ ) {
const char * key = toml_key_in ( tab , i );
if (! key ) break ;
printf ( "key %d: %sn" , i , key );
}TOML 数组可以使用整数索引取消引用。一般来说，数组上的所有访问方法都被命名为toml_*_at() 。
要获取数组的大小：
int size = toml_array_nelem ( arr );要获取数组的内容，请使用有效索引并调用以下函数之一：
toml_string_at ( arr , idx );
toml_bool_at ( arr , idx );
toml_int_at ( arr , idx );
toml_double_at ( arr , idx );
toml_timestamp_at ( arr , idx );
toml_table_at ( arr , idx );
toml_array_at ( arr , idx );一些toml_*_at和toml_*_in函数返回 toml_datum_t 结构。结构中的ok标志指示函数调用是否成功。如果是这样，您可以继续读取与内容类型相对应的值。
例如：
toml_datum_t host = toml_string_in(tab, "host");
if (host.ok) {
printf("host: %sn", host.u.s);
free(host.u.s); /* FREE applies to string and timestamp types only */
}
** 重要：如果访问的值是字符串或时间戳，则使用后必须分别调用free(datum.us)或free(datum.u.ts) 。 **
正常的品牌就足够了。您还可以简单地将toml.c和toml.h文件包含在项目中。
调用make install会将头文件和库文件安装到 /usr/local/{include,lib} 中。
或者，指定make install prefix=/a/file/path以安装到 /a/file/path/{include,lib}。
要针对 toml-lang/toml-test 提供的标准测试集进行测试：
% make
% cd test1
% bash build.sh # do this once
% bash run.sh # this will run the test suite要针对 iarna/toml 提供的标准测试集进行测试：
% make
% cd test2
% bash build.sh # do this once
% bash run.sh # this will run the test suite
