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 suiteiarna/toml によって提供される標準テスト セットに対してテストするには:
% make
% cd test2
% bash build.sh # do this once
% bash run.sh # this will run the test suite
