toml11/docs/content.ja/docs/reference/literal.md

+++ title = "literal.hpp" type = "docs" +++

literal.hpp

literal.hppでは、_tomlリテラルが定義されます。

_tomlリテラルは、文字列リテラルをパースしてtoml::valueに変換します。

namespace toml
{
inline namespace literals
{
inline namespace toml_literals
{
toml::value operator"" _toml(const char* str, std::size_t len);
toml::value operator"" _toml(const char8_t* str, std::size_t len); // C++20以降
} // toml_literals
} // literals
} // toml

自由関数

operator"" _toml(char)

toml::value operator"" _toml(const char* str, std::size_t len);

文字列リテラルをパースしてtoml::valueに変換します。

通常のTOMLファイルの場合、toml::parseと同等の処理が行われます。

const auto v1 = "a = 'foo'"_toml; // v1: {a = 'foo'}

改行を含む場合、生文字列リテラルが便利です。

const auto v1 = R"(
    a = 42
    b = "foo"
)"_toml;

値が単体で書かれていた場合、その値になります。

const auto v2 = "'foo'"_toml;     // v2: 'foo'

TOMLは数値のみからなるキーを許可しています。 [1]のように、テーブル定義と配列の区別がつかない場合、テーブル定義が優先されます。

配列として解釈させるには、trailing commaを使用してください。

const auto v3 = "[1]"_toml;  // v3: {1 = {}}
const auto v4 = "[1,]"_toml; // v4: [1,]

operator"" _toml(char8_t)

char8_tが利用可能な場合に定義されます。引数の型のほかに違いはありません。

例

#include <toml.hpp>
int main()
{
    using namespace toml::literals::toml_literals;
    const auto v = "a = \"foo\""_toml;
    assert(v.at("a").as_string() == "foo");
    return 0;
}