= 值转换 尽管 <> 容器便于创建临时结构，但通常仍需在 JSON 与用户自定义类型或标准库类型之间进行转换。 函数模板 <> 提供了从类型 `T` 构造 <> 的接口。函数模板 <> 则执行相反方向的转换，从类型 `T` 转换为 <>。两者均支持多种不同的 https://en.cppreference.com/w/cpp/language/types[基础类型]（如 `int` 或 `double`）、标准库类型（如 `std::string` 或 `std::vector`），并可扩展以支持用户定义类型。 对于类型 `T`，将从以下类别列表中选择合适的转换方式，并采用第一个匹配的类别。 Category of T Comment `value_from` behavior `value_to` behavior 自定义行为。 自定义行为。 Boost.JSON 容器 结果等于输入值。 结果等于输入值。 https://en.cppreference.com/w/cpp/types/is_arithmetic[Arithmetic type] a| 结果是一个与输入值相等的数字，并且其类型为 若 `T` 为有符号整数，则为 `std::int64_t`；或 若 `T` 为无符号整数，则为 `std::uint64_t`；或 否则为 `double`。 结果通过 <> 创建。 满足 <> 的类型 适用于类似 {std_monostate} 的类型。 结果为空值。 结果将被默认构造。 满足 <> 的类型。 `char` 序列，例如 `std::string`。 结果为 <>。 结果由 <> 构造。 满足 <> 的类型。 `std::variant` 及类似类型，例如 `boost::variant2::variant`。 结果等同于对活跃的变体备选项进行转换所得的结果。 a| 结果为一个数值，等于输入值且类型为： Type satisfying <> 若输入值为空，则结果为 `null`；否则该结果 等同于将存储在可选对象内部的对象进行转换。| 如果输入值为 `null` ，则结果将默认进行构造。否则，结果将根据将输入转换为存储在可选对象中的类型所得到的结果进行构造。 Type satisfying <>. A one-to-one mapping (e.g. `std::map`) with string-like keys. The result is an <>. The result is default-constructed, and elements are `insert`-ed at the end. Type satisfying <>. A sequence of elements, e.g. `std::vector`. 结果是一个 <>。 满足 <> 的类型。 一种具有固定大小的异构序列，例如 `std::tuple` 和 `std::pair`。 结果通过将数组元素作为构造函数参数进行构造。 满足 <> 的类型。 结果是一个 <>，其键为描述性成员的名称。 结果将被默认构造，并为其所描述的成员赋予相应的值。 相应的值。 满足 <> 的类型。 如果输入值等于某个已描述的枚举项，则结果为 一个包含该枚举项名称的 <>；否则，结果等同于将输入值转换为其底层类型后的值。 满足 <> 的类型。 `std::filesystem::path` 及类似类型，例如 `boost::filesystem::path`。 结果等于 `path::generic_string` 的结果。 结果由两个指向 `const char` 的指针构造而成。 对于复合类型（如序列、元组、已描述的类等），对其所包含对象的转换会递归应用。例如： 在这里，该地图会被转换为一个 <>，因为其符合 <> 这个条件。其每个键都会被转换为一个 <>，因为 `std::string` 符合 <> 这个条件，而其每个值都会被转换为一个 <>，因为 `std::pair` 符合 <> 这个条件。最后，对每个 `std::pair` 的元素进行转换，将其转换为一个 `std::int64_t` 数字和一个 `bool` 值。 :leveloffset: +1 include::custom.adoc[] include::nothrow.adoc[] include::alloc.adoc[] include::context.adoc[] include::forward.adoc[] include::direct.adoc[] include::guidelines.adoc[] :leveloffset: -1