msgid "" msgstr "" "Project-Id-Version: Chinese (Simplified Han script) (Boost Json Translation " "(zh_Hans))\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2026-06-07 04:35+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: Chinese (Simplified Han script) \n" "Language: zh_Hans\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=1; plural=0;\n" "X-Generator: Weblate 2026.5\n" #: :10 #, safe-html, strict-same msgid "" "= Custom Conversions Boost.JSON uses two mechanisms to customize conversion " "between <> and user types. One mechanism involves specializing " "type traits. The other one is more powerful and requires defining overloads " "of `tag_invoke`. Both mechanisms will be further explained in this section." msgstr "" "= 自定义转换 Boost.JSON 提供了两种机制用于自定义 <> 与用户类" "型之间的转换。一种机制涉及特化类型特征（type traits）。另一种机制更强大，需要" "定义`tag_invoke`的重载。本节将进一步解释这两种机制。" #: :16 #, safe-html, strict-same msgid "Conversion Traits" msgstr "转换特征" #: :17 #, safe-html, strict-same msgid "" "Previously a number of conversion type traits, like <> or " "<>, were introduced. The library tries the traits one " "after another and uses the implementation that corresponds to the first " "matching trait. In some cases, though, a type would match a trait with a " "higher priority, but the user intends for it to belong to a lower priority " "category. If this happens the user can specialize the trait that's not " "supposed to match for that type to be an equivalent of `std::false_type`." msgstr "" "之前已经介绍了一些转换类型特征，例如 <> 或 " "<>。库会依次尝试这些特征，并使用与第一个匹配特征" "对应的实现。然而，在某些情况下，某个类型可能会匹配到优先级更高的特征，而用户" "实际希望将其归入优先级更低的类别。如果发生这种情况，用户可以针对该类型特化那" "个不应匹配的特征，使其等同于`std::false_type`。" #: :25 #, safe-html, strict-same msgid "Consider this type:" msgstr "考虑以下类型：" #: :32 #, safe-html, strict-same msgid "" "It exposes both a sequence API and a tuple API. But converting from " "<> to `user_ns::ip_address` would not be able to use " "implementation for sequences, since those are constructed empty and then " "populated one element at a time, while `ip_address` has a fixed size of 4. " "The tuple conversion would fit, though. The only problem is that " "<> has a lower priority than <>. In " "order to circumvent this, the user only needs to specialize " "<> to not match `ip_address`." msgstr "" "它同时暴露了序列（sequence）API 和元组（tuple）API。然而，从 <" "> 转换到 user_ns::ip_address 时无法使用序列的实现，因为序列类型的转换会先" "构造一个空对象，再逐个填充元素，而 ip_address 的大小固定为 4。相比之下，元组" "转换是合适的。唯一的问题在于 <> 的优先级低于 " "<>。为绕过此问题，用户只需特化 " "<>，使其对 ip_address 不匹配即可。" #: :45 #, safe-html, strict-same msgid "`tag_invoke` Overloads" msgstr "`tag_invoke`重载" #: :46 #, safe-html, strict-same msgid "" "The second, more powerful approach, is to provide the conversion " "implementation yourself. With Boost.JSON this is done by defining an " "overload of `tag_invoke` function (the benefits of this mechanism are " "outlined in http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2019/" "p1895r0.pdf[C++ proposal P1895]. In essence, `tag_invoke` provides a uniform " "interface for defining customization points by using argument-dependent " "lookup to find a viable overload from the point at which it is called. As " "the name suggests, a tag type is passed as an argument in order to:" msgstr "" "第二种、更强大的方法是自行提供转换实现。在 Boost.JSON 中，这是通过定" "义`tag_invoke`函数的重载来实现的（该机制的优点详见 http://www.open-std.org/" "jtc1/sc22/wg21/docs/papers/2019/p1895r0.pdf[C++提案P1895]）。本质上" "，`tag_invoke` 通过参数依赖查找（ADL）在调用点寻找可用的重载，从而为自定义扩" "展点提供统一接口。顾名思义，一个标签类型作为参数传递，用于：" #: :55 #, safe-html, strict-same msgid "discard candidates that are unrelated to that particular" msgstr "排除与该特定自定义点无关的候选函数，" #: :56 #, safe-html, strict-same msgid "customization point, and" msgstr "并且" #: :58 #, safe-html, strict-same msgid "" "embed the user-defined type into the arguments list (e.g. by using a tag type" msgstr "将用户自定义类型嵌入到参数列表中（例如，通过使用" #: :59 #, safe-html, strict-same msgid "" "template such as `value_to_tag`) so that its http://eel.is/c++draft/" "basic.lookup.argdep#2[associated namespaces and entities] are examined when " "name lookup is performed." msgstr "" "像`value_to_tag`这样的标签类型模板），以便在执行名称查找时检查其http://" "eel.is/c++draft/basic.lookup.argdep#2[关联的命名空间和实体]。" #: :63 #, safe-html, strict-same msgid "" "This has the effect of finding user-provided `tag_invoke` overloads, even if " "they are declared (lexically) after the definition of the calling function." msgstr "" "这能够识别用户提供的`tag_invoke`重载函数，即便这些重载函数是（从词法角度来看" "）在调用函数的定义之后声明的。" #: :66 #, safe-html, strict-same msgid "Overloads of `tag_invoke` called by <> take the form:" msgstr "" "由 <> 调用的 `tag_invoke` 的重载形式如下：" #: :68 #, safe-html, strict-same msgid "``` void tag_invoke( const value_from_tag&, value&, T ); ```" msgstr "``` void tag_invoke( const value_from_tag&, value&, T ); ```" #: :72 #, safe-html, strict-same msgid "" "While overloads of `tag_invoke` called by <> take the form:" msgstr "" "而由 <> 调用的`tag_invoke`重载采用以下形式：" #: :74 #, safe-html, strict-same msgid "``` T tag_invoke( const value_to_tag< T >&, const value& ); ```" msgstr "" "``` T tag_invoke( const value_to_tag< T >&, const value& ); ```" #: :78 #, safe-html, strict-same msgid "" "If we implemented conversion for `user_ns::ip_address` manually with this " "approach, it would look like this:" msgstr "" "如果我们采用这种方式手动对 `user_ns::ip_address` 进行转换，其效果将会是这样的" "：" #: :86 #, safe-html, strict-same msgid "" "Since the type being converted is embedded into the function's signature, " "user-provided overloads are visible to argument-dependent lookup and will be " "candidates when a conversion is performed:" msgstr "" "由于要转换的类型已嵌入到函数的签名中，因此用户自定义的重载形式会出现在依赖于" "参数的查找过程中，并且在进行转换时会成为候选选项：" #: :95 #, safe-html, strict-same msgid "" "Users can freely combine types with custom conversions with types with " "library-provided conversions. The library handles them correctly:" msgstr "" "用户可以自由地将具有自定义转换的类型与具有库提供转换的类型组合使用，库能正确" "处理它们："