Международные компоненты для Юникода (ICU)

Международные компоненты для Юникода (ICU) — это зрелый и широко используемый набор API глобализации с открытым кодом. ICU использует обширный репозиторий общих языковых стандартов Юникода (CLDR) в качестве библиотеки данных, обеспечивая поддержку глобализации для программных приложений. ICU широко переносится и дает приложениям одинаковые результаты на всех платформах.

Основные сведения о службах API глобализации, предоставляемых ICU

• Преобразование кодовых страниц. Преобразуйте текстовые данные в Юникод или из нее, а также практически любую другую кодировку или кодировку. Таблицы преобразования ICU основаны на данных наборов символов, собранных IBM в течение многих десятилетий, и являются наиболее полными, доступными в любом месте.
• Параметры сортировки. Сравнение строк в соответствии с соглашениями и стандартами определенного языка, региона или страны. Параметры сортировки ICU основаны на алгоритме сортировки Юникод, а также на правилах сравнения для конкретного языкового стандарта из CLDR.
• Форматирование. Форматируйте числа, даты, время и денежные суммы в соответствии с соглашениями выбранного языкового стандарта. Сюда входит перевод названий месяцев и дней на выбранный язык, выбор соответствующих сокращений, правильное упорядочивание полей и т. д. Эти данные также поступают из репозитория общих данных языкового стандарта.
• Вычисления времени. Несколько типов календарей предоставляются за пределами традиционных григорианских. Предоставляется подробный набор API вычислений часовых поясов.
• Поддержка Юникода. ICU внимательно отслеживает стандарт Юникода, обеспечивая простой доступ ко всем свойствам символов Юникода, нормализации Юникода, свертыванием регистра и другим фундаментальным операциям, указанным в стандарте Юникода.
• Регулярные выражения. Регулярные выражения ICU полностью поддерживают Юникод, обеспечивая при этом высокую конкурентоспособность.
• Bidi: поддержка обработки текста, содержащего смесь данных слева направо (английский) и справа налево (арабский или иврит).

Дополнительные сведения см. на веб-сайте ICU: http://site.icu-project.org/

Общие сведения

В Windows 10 Creators Update ICU был интегрирован в Windows, что сделало API C и данные общедоступными.

Документацию по API C ICU см. на официальной странице документации по ICU здесь: http://icu-project.org/apiref/icu4c/index.html#Module

Журнал изменений в библиотеке ICU в Windows

Версия 1703 (Creators Update)

Библиотека ICU была впервые добавлена в ос Windows 10 в этой версии. Он был добавлен в виде:

• Две системные библиотеки DLL:
  • icuuc.dll (это "общая" библиотека ICU)
  • icuin.dll (это библиотека ICU i18n)
• Два файла заголовков в пакете SDK для Windows 10:
  • icucommon.h
  • icui18n.h
• Две библиотеки импорта в пакете SDK для Windows 10:
  • icuuc.lib
  • icuin.lib

Версия 1709 (Fall Creators Update)

Добавлен объединенный файл заголовка icu.h, который содержит содержимое обоих указанных выше файлов заголовков (icucommon.h и icui18n.h), а также изменяет тип UCHAR на char16_t.

Версия 1903 (обновление за май 2019 г.)

Добавлена новая объединенная библиотека DLL ,icu.dll, которая содержит библиотеки common и i18n. Кроме того, в пакет SDK для Windows 10 добавлена новая библиотека импорта: icu.lib.

В дальнейшем новые API не будут добавлены в старые заголовки (icucommon.h и icui18n.h) или в старые библиотеки импорта (icuuc.lib и icuin.lib). Новые API будут добавлены только в объединенный заголовок (icu.h) и объединенную библиотеку импорта (icu.lib).

Приступая к работе

Необходимо выполнить три main шага: (Windows 10 Creators Update или более поздней версии).

1. Приложение должно быть предназначено Windows 10 версии 1703 (Creators Update) или более поздней.

2. Добавьте в заголовки:

   #include <icucommon.h>
   #include <icui18n.h>
   

   В Windows 10 версии 1709 и более поздних следует включить объединенный заголовок:

   #include <icu.h>
   

3. Ссылка на две библиотеки:

   • icuuc.lib
   • icuin.lib

   В Windows 10 версии 1903 и выше следует использовать объединенную библиотеку:

   • icu.lib

Затем можно вызвать любой API C ICU из этих библиотек. (API C++ не предоставляются.)

Пример приложения ICU

Пример фрагмента кода

Ниже приведен пример, демонстрирующий использование API-интерфейсов ICU из приложения UWP на C++. (Оно не предназначено для полного автономного приложения, скорее это просто пример вызова метода ICU.)

В следующем небольшом примере предполагается, что существуют методы ErrorMessage и OutputMessage , которые каким-то образом выводят строки пользователю.

// On Windows 10 Creators Update, include the following two headers. With Windows 10 Fall Creators Update and later, you can just include the single header <icu.h>.
#include <icucommon.h>
#include <icui18n.h>

void FormatDateTimeICU()
{
    UErrorCode status = U_ZERO_ERROR;

    // Create a ICU date formatter, using only the 'short date' style format.
    UDateFormat* dateFormatter = udat_open(UDAT_NONE, UDAT_SHORT, nullptr, nullptr, -1, nullptr, 0, &status);

    if (U_FAILURE(status))
    {
        ErrorMessage(L"Failed to create date formatter.");
        return;
    }

    // Get the current date and time.
    UDate currentDateTime = ucal_getNow();

    int32_t stringSize = 0;
    
    // Determine how large the formatted string from ICU would be.
    stringSize = udat_format(dateFormatter, currentDateTime, nullptr, 0, nullptr, &status);

    if (status == U_BUFFER_OVERFLOW_ERROR)
    {
        status = U_ZERO_ERROR;
        // Allocate space for the formatted string.
        auto dateString = std::make_unique<UChar[]>(stringSize + 1);

        // Format the date time into the string.
        udat_format(dateFormatter, currentDateTime, dateString.get(), stringSize + 1, nullptr, &status);

        if (U_FAILURE(status))
        {
            ErrorMessage(L"Failed to format the date time.");
            return;
        }

        // Output the formatted date time.
        OutputMessage(dateString.get());
    }
    else
    {
        ErrorMessage(L"An error occured while trying to determine the size of the formatted date time.");
        return;
    }

    // We need to close the ICU date formatter.
    udat_close(dateFormatter);
}