tomlc99

湯姆LC99

c99 中的 TOML；相容於 v1.0。

如果您正在尋找 C++ 庫，您可以嘗試這個包裝器：https://github.com/cktan/tomlcpp。

• 相容於 TOML v1.0.0。
• 使用多個測試套件進行測試，包括 toml-lang/toml-test 和 iarna/toml-spec-tests。
• 提供非常簡單直覺的介面。

用法

詳細資訊請參閱toml.h檔。以下是解析此設定檔的簡單範例：

[ server ]
	host = " www.example.com "
	port = [ 8080 , 8181 , 8282 ]

以下是從文件中取得值的常見步驟：

1. 解析 TOML 檔案。
2. 遍歷並定位 TOML 中的表格。
3. 從表中提取值。
4. 釋放分配的記憶體。

下面是解析範例表中的值的範例。

 #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_datum_t

一些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