[#bilingual_str]
= bilingual_str
:mrdocs:

Bilingual messages: ‐ in GUI: user's native language + untranslated (i.e. English) ‐ in log and stderr: untranslated only

== Synopsis

Declared in `<util/translation.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
struct bilingual_str;
----

== Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:bilingual_str/clear.adoc[`clear`] 
| Reset both the original and translated text to empty.
| xref:bilingual_str/empty.adoc[`empty`] 
| Test whether the original text is empty.
| xref:bilingual_str/operator_plus_eq.adoc[`operator+=`] 
| Append another bilingual string to this one.
|===


== Data Members

[cols="1,4"]
|===
| Name| Description
| xref:bilingual_str/original.adoc[`original`] 
| The untranslated (English) text.
| xref:bilingual_str/translated.adoc[`translated`] 
| The text translated to the user's native language.
|===


== Non-Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:InitError-06.adoc[`InitError`]
| Show error message with additional detail lines.
| xref:InitError-0b.adoc[`InitError`]
| Show error message
| xref:InitWarning.adoc[`InitWarning`]
| Show warning message
| xref:Untranslated.adoc[`Untranslated`]
| Mark a bilingual_str as untranslated
| xref:noui_ThreadSafeMessageBox.adoc[`noui_ThreadSafeMessageBox`]
| Non‐GUI handler, which logs and prints messages.
| xref:noui_ThreadSafeQuestion.adoc[`noui_ThreadSafeQuestion`]
| Non‐GUI handler, which logs and prints questions.
| xref:operator_plus-0d.adoc[`operator+`]
| Concatenate two bilingual strings.
| xref:common/AmountErrMsg.adoc[`common::AmountErrMsg`]
| Build the error message for an invalid amount value.
| xref:common/AmountHighWarn.adoc[`common::AmountHighWarn`]
| Build a warning that a configured amount is unusually high.
| xref:common/InvalidPortErrMsg.adoc[`common::InvalidPortErrMsg`]
| Build the error message for an invalid port value.
| xref:common/PSBTErrorString.adoc[`common::PSBTErrorString`]
| Return a bilingual message describing a PSBT error.
| xref:common/ResolveErrMsg.adoc[`common::ResolveErrMsg`]
| Build the error message for a failed address resolution.
| xref:common/TransactionErrorString.adoc[`common::TransactionErrorString`]
| Return a bilingual message describing a transaction error.
| xref:tinyformat/format-0a.adoc[`tinyformat::format`]
| Format a bilingual string from a bilingual format string and its arguments.
| xref:util/ErrorString-01.adoc[`util::ErrorString`]
| Extracts the error message from a result.
| xref:util/ErrorString-07.adoc[`util::ErrorString`]
| Extracts the error message from a result.
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#