features #

ここでは、toml11が提供する主な機能について、例を挙げながら説明します。

ファイル・文字列をパースする #

ファイルや文字列をパースする関数と、それが出力するエラーの扱い方について説明します。

以下の内容を含みます。

• ファイルをパースする
• 文字列をパースする
• バイト列をパースする
• 例外を投げずにファイルをパースする
• 例外を投げずに文字列をパースする
• 例外を投げずにバイト列をパースする

toml::valueから値を取り出す #

toml::valueが持つデータの型を調べ、取り出す方法、型変換を行う方法について説明します。

以下の内容を含みます。

• メンバ関数を使って値の型を調べる
• メンバ関数を使って値にアクセスする
• コメントにアクセスする
• インラインテーブル・ドットキーの取り扱い
• 日付情報の取り扱い
• toml::get<T>を使って変換する
• toml::get_orを使って失敗時の値を指定する
• toml::find<T>を使って検索と変換を行う
• toml::find_orを使って失敗時の値を指定する
• ユーザー定義型との変換を定義する
• toml::visitで関数を適用する
• toml::valueを構築する

エラーメッセージを作る #

toml::valueの値を使って、TOMLファイル中の位置情報つきのエラーメッセージを生成する方法について説明します。

以下の内容を含みます。

• toml::value の位置情報を取り出す
• エラーメッセージを構築する
• 出力に色を付ける

TOMLファイルを出力する #

toml::valueの値をフォーマットする方法と、可能なフォーマット指定について説明します。

以下の内容を含みます。

• toml::valueの値ごとにフォーマットを指定する
• toml::valueをフォーマットして文字列化する

toml::valueの型を変更する #

toml::valueが格納する型（integer_typeやtable_typeをカスタマイズする方法について説明します。

以下の内容を含みます。

• type_configの定義
• ordered_type_configを使用する
• コメントを保存しないようにする
• std::dequeなどの異なるコンテナを使用する
• boost::multiprecisionなどの異なる数値型を使用する

TOMLリテラル #

C++内にTOMLファイルを埋め込むための_tomlリテラルについて説明します。

以下の内容を含みます。

• TOMLリテラルを使用する

TOML言語バージョン #

toml11がサポートするTOML言語のバージョン、主にTOML-v1.1.0で追加された言語機能を制御する方法について説明します。

以下の内容を含みます。

• TOML言語の1.1.0を使用する
• TOML言語の1.1.0の一部の機能のみ使用する

TOML言語拡張 #

toml11独自のTOML言語拡張について説明します。

以下の内容を含みます。

• null をサポートする
• 浮動小数点数の16進数フォーマットをサポートする
• 数値に単位を付けられるようにする