International Components for Unicode (ICU)

[アーティクル]
06/13/2023

International Components for Unicode (ICU) は、オープンソースのグローバリゼーション API の成熟した広く使用されているセットです。 ICU は Unicode の膨大な共通ロケールデータリポジトリ (CLDR) をデータライブラリとして利用し、ソフトウェアアプリケーションのグローバリゼーションサポートを提供します。 ICU は広く移植可能であり、すべてのプラットフォームでアプリケーションに同じ結果を提供します。

ICU が提供するグローバリゼーション API サービスのハイライト

コードページ変換: テキストデータを Unicode とその他のほぼすべての文字セットまたはエンコードとの間で変換します。 ICU の変換テーブルは、何十年もの間に IBM によって収集された文字セットデータに基づいており、どこでも使用できる最も完全なテーブルです。
照合順序: 特定の言語、地域、または国の規則と標準に従って文字列を比較します。 ICU の照合順序は、Unicode 照合順序アルゴリズムと CLDR のロケール固有の比較規則に基づいています。
書式設定: 選択したロケールの規則に従って、数値、日付、時刻、通貨の金額を書式設定します。これには、月と日の名前を選択した言語に変換すること、適切な省略形の選択、フィールドの正しい順序付けなどが含まれます。このデータは、共通ロケールデータリポジトリからも取得されます。
時間計算: 従来のグレゴリオ暦を超えて、複数の種類のカレンダーが提供されます。タイムゾーン計算 API の完全なセットが用意されています。
Unicode のサポート: ICU は Unicode 標準を厳密に追跡し、Unicode 標準で指定されている多くの Unicode 文字プロパティ、Unicode 正規化、大文字と小文字の折りたたみ、その他の基本的な操作すべてに簡単にアクセスできます。
正規表現: ICU の正規表現は、非常に競争力のあるパフォーマンスを提供しながら、Unicode を完全にサポートします。
Bidi: 左から右 (英語) と右から左 (アラビア語またはヘブライ語) のデータの組み合わせを含むテキストの処理をサポートします。

詳細については、ICU Web サイトを参照してください。 http://site.icu-project.org/

概要

Windows 10 Creators Updateでは、ICU が Windows に統合され、C API とデータにパブリックにアクセスできるようになります。

重要

Windows の ICU のバージョンでは、C API のみが公開されます。 C++ API は公開されません。残念ながら、C++ では安定した ABI がないため、C++ API を公開することは不可能です。

ICU C API のドキュメントについては、こちらの公式 ICU ドキュメントページを参照してください。 http://icu-project.org/apiref/icu4c/index.html#Module

Windows の ICU ライブラリの変更履歴

バージョン 1703 (Creators Update)

ICU ライブラリは、このバージョンの Windows 10 OS に最初に追加されました。次のように追加されました。

2 つのシステム DLL:
- icuuc.dll (これは ICU の "共通" ライブラリです)
- icuin.dll (これは ICU "i18n" ライブラリです)
Windows 10 SDK の 2 つのヘッダーファイル:
- icucommon.h
- icui18n.h
Windows 10 SDK の 2 つのインポートライブラリ:
- icuuc.lib
- icuin.lib

バージョン 1709 (Fall Creators Update)

上記の両方のヘッダーファイル ( icucommon.h と icui18n.h) の内容を含む、結合されたヘッダーファイル icu.h が追加され、の UCHAR 型もに char16_t変更されました。

バージョン 1903 (2019 年 5 月の更新プログラム)

"共通" ライブラリと "i18n" ライブラリの両方を含む、新しい組み合わせ DLLicu.dllが追加されました。また、新しいインポートライブラリが Windows 10 SDK: icu.lib に追加されました。

今後、古いヘッダー (icucommon.h と icui18n.h) や古いインポートライブラリ (icuuc.lib と icuin.lib) には、新しい API は追加されません。新しい API は、結合されたヘッダー (icu.h) と結合されたインポートライブラリ (icu.lib) にのみ追加されます。

作業の開始

次の 3 つのメイン手順があります(Windows 10 Creators Update以降)

アプリケーションは、バージョン 1703 (Creators Update) 以降Windows 10ターゲットにする必要があります。
ヘッダーにを追加します。
```
#include <icucommon.h>
#include <icui18n.h>
```
バージョン 1709 以降Windows 10では、代わりに結合ヘッダーを含める必要があります。
```
#include <icu.h>
```
次の 2 つのライブラリにリンクします。
- icuuc.lib
- icuin.lib
バージョン 1903 以降Windows 10では、代わりに組み合わされたライブラリを使用する必要があります。
- icu.lib

その後、これらのライブラリから任意の ICU C API を呼び出すことができます。 (C++ API は公開されません)。

重要

従来のインポートライブラリである icuuc.lib と icuin.lib を使用している場合は、onecoreuap.lib や WindowsApp.lib などのアンブレラライブラリの前にある [追加の依存関係リンカー] 設定にそれらのライブラリが一覧表示されていることを確認します (下の図を参照)。それ以外の場合、リンカーは icu.lib にリンクするため、実行時にicu.dllを読み込もうとします。その DLL は、バージョン 1903 以降でのみ存在します。そのため、ユーザーがバージョン 1903 より前の Windows マシンで Windows 10 SDK をアップグレードすると、アプリの読み込みと実行に失敗します。 Windows の ICU ライブラリの履歴については、「Windows の ICU ライブラリの変更履歴」を参照してください。

icu の例

注意

これは、"すべてのプラットフォーム" の構成です。
Win32 アプリで ICU を使用するには、まず CoInitializeEx を呼び出す必要があります。結合 Windows 10された ICU ライブラリ (icu.dll/icu.lib) が使用可能なバージョン 1903 以降では、結合されたライブラリを使用して CoInitializeEx 呼び出しを省略できます。
ICU API によって返されるすべてのデータが Windows OS と一致するとは限りません。このアラインメント作業はまだ進行中です。

ICU サンプルアプリ

コードスニペットの例

C++ UWP アプリケーション内からの ICU API の使用を示す例を次に示します。 (完全なスタンドアロンアプリケーションではなく、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);
}

次の方法で共有

International Components for Unicode (ICU)

ICU が提供するグローバリゼーション API サービスのハイライト

概要

Windows の ICU ライブラリの変更履歴

バージョン 1703 (Creators Update)

バージョン 1709 (Fall Creators Update)

バージョン 1903 (2019 年 5 月の更新プログラム)

作業の開始

ICU サンプルアプリ

コードスニペットの例

フィードバック

その他のリソース

次の方法で共有

International Components for Unicode (ICU)

ICU が提供するグローバリゼーション API サービスのハイライト

概要

Windows の ICU ライブラリの変更履歴

バージョン 1703 (Creators Update)

バージョン 1709 (Fall Creators Update)

バージョン 1903 (2019 年 5 月の更新プログラム)

作業の開始

ICU サンプル アプリ

コード スニペットの例

フィードバック

その他のリソース

ICU サンプルアプリ

コードスニペットの例