Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://gammasoft71.github.io/xtd/docs/documentation/guides/xtd.core/internationalization below:

Internationalization | xtd

Xtd uses a number of user-readable strings, such as "open" or "save", which need to be translated into the user's language if it's different from English.

xtd has built-in support for internationalization, allowing this to happen automatically if translations into the current language are available.

You can find here a list of all existing translations with the addresses of the official translators you should contact if you wish to submit corrections to the translations for your language.

The following table shows all locales and corresponding languages :

If you wish to add a specific language not listed below, you can do so by using the ISO code 639-1.

See List of ISO 639-1 codes for complete list of languages.

To change the application locale, use std::locale::global method.

The following example show how to change the locale to french (France).

auto main() -> int {
  std::locale::global(std::locale {"fr_FR.utf-8"});
}

The following example show how to change the locale to russian (Russia).

auto main() -> int {
  std::locale::global(std::locale {"ru_RU.utf-8"});
}

Or use xtd::translate::locale method.

The following example show how to change the locale to french (France).

auto main() -> int {
  xtd::translate::locale("fr_FR");
}

The following example show how to change the locale to russian (Russia).

auto main() -> int {
  xtd::translate::locale("ru_RU");
}

To change the application language without changing locale use xtd::translate::language method.

The following example show how to change the language to french (France).

auto main() -> int {
  xtd::translate::language("fr");
}

The following example show how to change the language to russian (Russia).

auto main() -> int {
  xtd::translate::language("ru");
}

The locale impact the format string as currency and date time see Format number, dates other types for more information.

To mark a string for translation use xtd::translator::translate method or operator""_t literal operator.

The following example shows how to marks a string for translation with xtd::translator::translate method.

auto main() -> int {
  auto str = translator::translate("This is a sor translation tring fexample.");

  console::write_line(str);
}

The following example shows how to marks a string for translation with operator""_t literal operator.

auto main() -> int {
  auto str = "This is a sor translation tring fexample."_t;

  console::write_line(str);
}

The followng file example show the strings file format for translation

menu.strings :

# This file is used to translate menu items into French.

key "&File"
value "&Fichier"

key "&Edit"
value "&Editer"

key "&Vew"
value "&Vue"

key "&Window"
value "&Fenêtre"

key "&Help"
value "&Aide"

• Start comment with #
• The string literal in the source faile starts with the keyword key and must be in double quotes ".
• The transated string starts with the keyword value and must be in double quotes ".

The strings file, for each language, must be in a directory with the ISO code 639-1 as its name, possibly followed by the underscore _ and the two uppercase letters of the country code.

The languages directories should be located in the locale folder, next to the src folder containing your application sources.

String files have no fixed name. The name and number of chain files can be arbitrary, depending on how the project is organized.

The following example shows the hierarchy file for my_app project.

my_app
|- locale
|   |- en
|   |  |- messages.strings
|   |  |- menu_items.strings
|   |  |- texts.strings
|   |- en_GB
|   |  |- messages.strings
|   |  |- menu_items.strings
|   |  |- texts.strings
|   |- fr
|   |  |- messages.strings
|   |  |- menu_items.strings
|   |  |- texts.strings
|   |- fr_CH
|   |  |- messages.strings
|   |  |- menu_items.strings
|   |  |- texts.strings
|   |- ru
|      |- messages.strings
|      |- menu_items.strings
|      |- texts.strings
|- src
|  |- my_app.cpp
|  |- my_app.h
|- CMakeLists.txt

English : en English (Australia) : en_AU French : fr French (Switzerland) : fr_CH

• Guides
• Documentation

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4