msgid "" msgstr "" "Project-Id-Version: English (Boost Json Translation (zh_Hans))\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2026-06-06 13:39+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: English \n" "Language: en\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=2; plural=n != 1;\n" "X-Generator: Weblate 2026.5\n" #: :10 #, read-only, safe-html, strict-same msgid "" "= Contextual Conversions Previously in this section we've been assuming that " "there is a particular fitting JSON representation for a type. But this is " "not always the case. Often one needs to represent particular value with JSON " "of certain format in one situation and with another format in a different " "situation. This can be achieved with Boost.JSON by providing an extra " "argument---context." msgstr "" "= Contextual Conversions Previously in this section we've been assuming that " "there is a particular fitting JSON representation for a type. But this is " "not always the case. Often one needs to represent particular value with JSON " "of certain format in one situation and with another format in a different " "situation. This can be achieved with Boost.JSON by providing an extra " "argument---context." #: :17 #, read-only, safe-html, strict-same msgid "Let's implement conversion from `user_ns::ip_address` to a JSON string:" msgstr "Let's implement conversion from `user_ns::ip_address` to a JSON string:" #: :25 #, read-only, safe-html, strict-same msgid "" "These `tag_invoke` overloads take an extra `as_string` parameter, which " "disambiguates this specific representation of `ip_address` from all other " "potential representations. In order to take advantage of them one needs to " "pass an `as_string` object to <> or <> as the " "last argument:" msgstr "" "These `tag_invoke` overloads take an extra `as_string` parameter, which " "disambiguates this specific representation of `ip_address` from all other " "potential representations. In order to take advantage of them one needs to " "pass an `as_string` object to <> or <> as the " "last argument:" #: :36 #, read-only, safe-html, strict-same msgid "" "Note, that if there is no dedicated `tag_invoke` overload for a given type " "and a given context, the implementation falls back to overloads without " "context. Thus it is easy to combine contextual conversions with conversions " "provided by the library:" msgstr "" "Note, that if there is no dedicated `tag_invoke` overload for a given type " "and a given context, the implementation falls back to overloads without " "context. Thus it is easy to combine contextual conversions with conversions " "provided by the library:" #: :46 #, read-only, safe-html, strict-same msgid "Conversions for Third-Party Types" msgstr "Conversions for Third-Party Types" #: :47 #, read-only, safe-html, strict-same msgid "" "Normally, you wouldn't be able to provide conversions for types from third-" "party libraries and standard types, because it would require yout to put " "`tag_invoke` overloads into namespaces you do not control. But with contexts " "you can put the overloads into your namespaces. This is because the context " "will add its associated namespaces into the list of namespaces where " "`tag_invoke` overloads are searched." msgstr "" "Normally, you wouldn't be able to provide conversions for types from third-" "party libraries and standard types, because it would require yout to put " "`tag_invoke` overloads into namespaces you do not control. But with contexts " "you can put the overloads into your namespaces. This is because the context " "will add its associated namespaces into the list of namespaces where " "`tag_invoke` overloads are searched." #: :54 #, read-only, safe-html, strict-same msgid "" "As an example, let's implement conversion for https://en.cppreference.com/w/" "cpp/chrono/system_clock[``std::chrono::system_clock::time_point``s] using " "https://en.wikipedia.org/wiki/ISO_8601[ISO 8601] format." msgstr "" "As an example, let's implement conversion for https://en.cppreference.com/w/" "cpp/chrono/system_clock[``std::chrono::system_clock::time_point``s] using " "https://en.wikipedia.org/wiki/ISO_8601[ISO 8601] format." #: :63 #, read-only, safe-html, strict-same msgid "Reverse conversion is left out for brevity." msgstr "Reverse conversion is left out for brevity." #: :65 #, read-only, safe-html, strict-same msgid "" "The new context is used in a similar fashion to `as_string` previously in " "this section." msgstr "" "The new context is used in a similar fashion to `as_string` previously in " "this section." #: :73 #, read-only, safe-html, strict-same msgid "" "One particular use case that is enabled by contexts is adaptor libraries " "that define JSON conversion logic for types from a different library." msgstr "" "One particular use case that is enabled by contexts is adaptor libraries " "that define JSON conversion logic for types from a different library." #: :76 #, read-only, safe-html, strict-same msgid "Passing Data to Conversion Functions" msgstr "Passing Data to Conversion Functions" #: :77 #, read-only, safe-html, strict-same msgid "" "Contexts we used so far were empty classes. But contexts may have data " "members and member functions just as any class. Implementers of conversion " "functions can take advantage of that to have conversions configurable at " "runtime or pass special objects to conversions (e.g. allocators)." msgstr "" "Contexts we used so far were empty classes. But contexts may have data " "members and member functions just as any class. Implementers of conversion " "functions can take advantage of that to have conversions configurable at " "runtime or pass special objects to conversions (e.g. allocators)." #: :82 #, read-only, safe-html, strict-same msgid "" "Let's rewrite conversion for ``system_clock::time_point``s to allow any " "format supported by `std::strftime`." msgstr "" "Let's rewrite conversion for ``system_clock::time_point``s to allow any " "format supported by `std::strftime`." #: :90 #, read-only, safe-html, strict-same msgid "" "This `tag_invoke` overload lets us change date conversion format at runtime. " "Also note, that there is no ambiguity between `as_iso_8601` overload and " "`date_format` overload. You can use both in your program:" msgstr "" "This `tag_invoke` overload lets us change date conversion format at runtime. " "Also note, that there is no ambiguity between `as_iso_8601` overload and " "`date_format` overload. You can use both in your program:" #: :99 #, read-only, safe-html, strict-same msgid "Combining Contexts" msgstr "Combining Contexts" #: :100 #, read-only, safe-html, strict-same msgid "" "Often it is needed to use several conversion contexts together. For example, " "consider a log of remote users identified by IP addresses accessing a " "system. We can represent it as " "`std::vector>`. " "We want to serialize both ``ip_address``es and ``time_point``s as strings, " "but for this we need both `as_string` and `as_iso_8601` contexts. To combine " "several contexts just use {std_tuple}. Conversion functions will select the " "first element of the tuple for which a `tag_invoke` overload exists and will " "call that overload. As usual, `tag_invoke` overloads that don't use contexts " "and library-provided generic conversions are also supported. Thus, here's " "our example:" msgstr "" "Often it is needed to use several conversion contexts together. For example, " "consider a log of remote users identified by IP addresses accessing a " "system. We can represent it as " "`std::vector>`. " "We want to serialize both ``ip_address``es and ``time_point``s as strings, " "but for this we need both `as_string` and `as_iso_8601` contexts. To combine " "several contexts just use {std_tuple}. Conversion functions will select the " "first element of the tuple for which a `tag_invoke` overload exists and will " "call that overload. As usual, `tag_invoke` overloads that don't use contexts " "and library-provided generic conversions are also supported. Thus, here's " "our example:" #: :117 #, read-only, safe-html, strict-same msgid "" "In this snippet `time_point` is converted using `tag_invoke` overload that " "takes `as_iso_8601`, `ip_address` is converted using `tag_invoke` overload " "that takes `as_string`, and {std_vector} is converted using a generic " "conversion provided by the library." msgstr "" "In this snippet `time_point` is converted using `tag_invoke` overload that " "takes `as_iso_8601`, `ip_address` is converted using `tag_invoke` overload " "that takes `as_string`, and {std_vector} is converted using a generic " "conversion provided by the library." #: :122 #, read-only, safe-html, strict-same msgid "Contexts and Composite Types" msgstr "Contexts and Composite Types" #: :123 #, read-only, safe-html, strict-same msgid "" "As was shown previously, generic conversions provided by the library forward " "contexts to conversions of nested objects. And in the case when you want to " "provide your own conversion function for a composite type enabled by a " "particular context, you usually also need to do that." msgstr "" "As was shown previously, generic conversions provided by the library forward " "contexts to conversions of nested objects. And in the case when you want to " "provide your own conversion function for a composite type enabled by a " "particular context, you usually also need to do that." #: :128 #, read-only, safe-html, strict-same msgid "" "Consider this example. As was discussed in a previous section, " "<> requires that your key type satisfies " "<>. Now, let's say your keys are not string-like, but " "they do convert to <>. You can make such maps to also convert to " "objects using a context. But if you want to also use another context for " "values, you need a way to pass the full combined context to map elements. " "So, you want the following test to succeed." msgstr "" "Consider this example. As was discussed in a previous section, " "<> requires that your key type satisfies " "<>. Now, let's say your keys are not string-like, but " "they do convert to <>. You can make such maps to also convert to " "objects using a context. But if you want to also use another context for " "values, you need a way to pass the full combined context to map elements. " "So, you want the following test to succeed." #: :141 #, read-only, safe-html, strict-same msgid "" "For this you will have to use a different overload of `tag_invoke`. This " "time it has to be a function template, and it should have two parameters for " "contexts. The first parameter is the specific context that disambiguates " "that particular overload. The second parameter is the full context passed to " "<> or <>." msgstr "" "For this you will have to use a different overload of `tag_invoke`. This " "time it has to be a function template, and it should have two parameters for " "contexts. The first parameter is the specific context that disambiguates " "that particular overload. The second parameter is the full context passed to " "<> or <>."