地域と言語の設定とコード生成

ソフトウェア開発ツールにおける地域と言語の設定のサポートは、効率的なグローバリゼーションの実現に不可欠です。将来的にロケールを超えて他のユーザーと共同作業を行う可能性がわずかでもある場合は、プロジェクトの開始時から地域と言語の設定を検討してください。地域と言語の設定によって、やり直しや、新しいモデル設計を開発しなければならないような状況を回避できます。関連要件はロケールの設定に関するものです。

ロケール設定

コンピューター上のロケール設定は、ユーザーインターフェイスの言語 (文字セットエンコード) と、時間、日付、通貨などの情報の表示形式を定義します。エンコードは 1 つのロケールでレンダリングできる文字数を指定します。たとえば、US-ASCII でコード化された文字セット (コードセット) は 128 文字を定義します。UTF-8 などの Unicode^® コードセットは、1,100,000 を超える文字数を定義します。

コード生成の場合、ロケール設定によって、生成されたファイルの内容の文字セットエンコードが決まります。文字化けや誤って表示される文字を防ぐには、MATLAB^® セッションのロケール設定がコンパイラおよびオペレーティングシステムの設定と互換性がなければなりません。オペレーティングシステムの設定の参照と変更の詳細については、地域と言語の設定またはオペレーティングシステムのドキュメンテーションを参照してください。

複数の言語とロケールが混在するコード生成の準備

モデルのコード生成を準備するには、以下を特定します。

オペレーティングシステムのロケール。
MATLAB セッションのロケール。
次のコード生成に関する要件。
- Target Language Compiler ファイル
- コメントを含むコード生成テンプレートファイル (Embedded Coder^® が必要)

文字セットの制約

Target Language Compiler ファイルはユーザーの既定のエンコードのみをサポートします。移植可能な国際的なカスタム生成コードを作成するには、7 ビット ASCII 文字セットを使用します。

XML エスケープシーケンスの置換

コードジェネレーターは、モデルの文字セットエンコードで表現されない文字を XML エスケープシーケンスで置き換えます。エスケープシーケンスの置換は、以下に表示されるブロック、信号および Stateflow^® オブジェクトの名前に対して行われます。

生成されたコードのコメント
コード生成レポート
MAT ファイルに記録されたブロックパス
C API ファイル model_capi.c (または .cpp) および model_capi.h に記録されたブロックパス

CGT ファイルと XML エスケープシーケンスの置換

コードジェネレーターは、モデルの文字セットエンコードで表現されない文字を XML エスケープシーケンスで置き換えます。エスケープシーケンスの置換は、コード生成テンプレート (CGT) ファイルのコメントに表示されるブロック、信号および Stateflow オブジェクトの名前に対して行われます。

既定では、コード生成テンプレートファイルには文字セットのエンコード情報は含まれません。オペレーティングシステムは、ファイルの書き込みに使用するエンコードに関係なく、現在のエンコードを使用してファイルを読み取ります。次のトークンをテンプレートファイルの最上部に追加することで、エスケープシーケンスの置換を有効にできます。

<encodingIn = "encoding">

encoding を、標準の文字エンコードスキームを指定する文字列 (UTF-8、ISO-8859–1、または windows-1251 など) で置き換えます。

例については、例のファイル MixedLanguagesAndLocales.cgt を開いてください。

openExample('ecoder/CodeWithMixedLanguagesAndLocalesECExample','supportingFile','MixedLanguagesAndLocales.cgt')

この例では、MATLAB セッションにおける windows-1251 用の MixedLanguagesAndLocales.cgt ファイルの内容を示します。encodingIn トークンはエンコードを UTF–8 に設定します。これはコード生成に適切な値です。

言語およびロケールが混在する C コードの生成とレビュー

この例では次を使用します。

スクリプトを開く

この例ではコードジェネレーターを使用して、混在する言語およびロケールで使用される C コードを生成する方法およびレビューする方法について説明します。

この例を使用する前に、地域と言語の設定とコード生成または地域と言語の設定とコード生成を参照してください。

モデル MixedLanguagesAndLocales の構成では、システムターゲットファイル ert.tlc を使用します。Simulink® Coder™ に関する地域と言語の設定とローカライズのサポートを確認するには、grt.tlc システムターゲットファイルを使用するようにモデルを設定します。この例は、Embedded Coder に固有のサポートを示します (コード生成テンプレートなど)。

モデルコンフィギュレーションでは、コードジェネレーターが次の内容についてローカライズを処理する方法を制御するファイルと設定を指定します。

C API インターフェイス
コード生成テンプレート (CGT) ファイル (Embedded Coder が必要)
コードのカスタマイズを適用する Target Language Compiler (TLC) ファイル (Embedded Coder が必要)

モデル例を開く

モデル例 MixedLanguagesAndLocales を開きます。モデル内のラベルは多言語 (アラビア語、中国語、英語、ドイツ語および日本語) とさまざまな Unicode の記号で表示されます。

model = 'MixedLanguagesAndLocales';
open_system(model);

Embedded Coder アプリを開く

[アプリ] タブで、[Embedded Coder] を選択します。

ロケール設定の確認

MATLAB® ソフトウェアのロケール設定がコンパイラと互換性があることを確認します。オペレーティングシステムのドキュメンテーションを参照してください。

コード生成テンプレートファイルの構成

コードの生成時に Unicode 文字を含むコード生成テンプレートファイルを使用するには、次の手順を実行します (Embedded Coder が必要)。それ以外の場合は次の節に進みます。

1. [コンフィギュレーションパラメーター] ダイアログボックスを開きます。

2. [コード生成]、[テンプレート] ペインに移動します。モデルはコード生成テンプレートファイル MixedLanguagesAndLocales.cgt を使用するように構成されています。このファイルは生成されたコードファイルの最上部にコメントを追加します。コードジェネレーターが .cgt ファイルにエスケープシーケンスの置換を適用するようにする場合は、次を指定して置換を有効にします。

<encodingIn = "encoding-name">

3. ファイル MixedLanguagesAndLocales.cgt を開きます。

edit MixedLanguagesAndLocales.cgt

4. 文字セットエンコード UTF-8 のエスケープシーケンスの置換を有効にしているコード行を検出します。

<encodingIn = "UTF-8">

5. ファイル MixedLanguagesAndLocales.cgt を閉じます。

コードカスタマイズファイルの構成

コードの生成時に Unicode 文字を含むファイルカスタマイズテンプレートを使用するには、次の手順を実行します (Embedded Coder が必要)。それ以外の場合は次の節に進みます。

TLC コードを使用して、生成コードファイルのカスタマイズを指定できます。TLC ファイルはユーザーの既定のエンコードのみをサポートします。移植可能な国際カスタム生成コードを作成するには、7 ビット ASCII 文字セットを使用します。

1. [コンフィギュレーションパラメーター] ダイアログボックスを開きます。

2. [コード生成]、[テンプレート] ペインに移動します。モデルはコードカスタマイズファイル example_file_process.tlc を使用するように設定されています。このファイルは、コードジェネレーターがコードファイルを書き込む直前に生成コードをカスタマイズします。たとえば、C のソースファイル、対応するインクルードファイル、#define ステートメントおよび #include ステートメントを追加します。

3. ファイル example_file_process.tlc を開きます。

edit example_file_process.tlc

4. コードを生成する前に、コードの次の行がコメント解除されていることを確認します。

assign ERTCustomFileTest = TLC_TRUE

5. ファイル example_file_process.tlc を閉じます。

C コードとレポートの生成

1. C コードを生成するためにモデルを設定します。次に、C コードおよびコード生成レポートを生成します。モデルコンフィギュレーションパラメーター [言語] を C に設定します。または、コマンドウィンドウで以下のように入力します。

set_param(model,'TargetLang','C');

2. C コードおよびコード生成レポートを生成します。

evalc('slbuild(model)');

生成コードのレビュー

コード生成レポートを使用して、生成コードを確認します。MATLAB の現在の文字セットエンコードではない文字については、コードジェネレーターはエスケープシーケンス置換を使用して、コード生成レポートの中で正しく文字をレンダリングします。

1. モデル MixedLanguagesAndLocales のコード生成レポートが開いていない場合は、コマンドウィンドウで次を入力します。

coder.report.open(model);

2. MixedLanguagesAndLocales.c および MixedLanguagesAndLocales.h の生成コードを確認します。モデル要素の名前が、ローカル言語に置換された名前としてコードコメントに現れます。

3. トレーサビリティレポートを開きます。このレポートでは、現在のエンコードで表現できない文字が名前に含まれている場合でも、トレーサビリティ情報が維持されます。モデル要素の名前は、ローカル言語に置換された名前としてレポートに現れます。

4. 下にスクロールして、最初のチャート (State 'Selection' <S2>:23) のコードの場所のリンクをクリックします。レポートの表示が変化し、対応するコードが MixedLanguagesAndLocales.c 内に表示されます。

5. コードコメント内の <S2>:23 リンクをクリックします。モデルウィンドウの新しいタブにチャートが表示されます。

6. モデルウィンドウでチャートを右クリックします。コンテキストメニューから [C/C++ コード]、[C/C++ コードに移動] を選択します。レポートの表示が変化し、そのチャートのコードの定数セクションが名前付きで表示されます。

7. コード生成レポート、モデルアドバイザー、モデルを閉じます。コマンドウィンドウで以下のように入力します。

coder.report.close();
bdclose(model);

言語およびロケールが混在する C++ コードの生成とレビュー

この例では次を使用します。

スクリプトを開く

この例ではコードジェネレーターを使用して、混在する言語およびロケールで使用される C++ コードを生成する方法およびレビューする方法について説明します。

この例を使用する前に、地域と言語の設定とコード生成または地域と言語の設定とコード生成を参照してください。

C++ API インターフェイス
コード生成テンプレート (CGT) ファイル (Embedded Coder が必要)
コードのカスタマイズを適用する Target Language Compiler (TLC) ファイル (Embedded Coder が必要)

モデル例を開く

model = 'MixedLanguagesAndLocales';
open_system(model);

Embedded Coder アプリを開く

[アプリ] タブで、[Embedded Coder] を選択します。

ロケール設定の確認

コード生成テンプレートファイルの構成

1. [コンフィギュレーションパラメーター] ダイアログボックスを開きます。

<encodingIn = "encoding-name">

3. ファイル MixedLanguagesAndLocales.cgt を開きます。

edit MixedLanguagesAndLocales.cgt

4. 文字セットエンコード UTF-8 のエスケープシーケンスの置換を有効にしているコード行を検出します。

<encodingIn = "UTF-8">

5. ファイル MixedLanguagesAndLocales.cgt を閉じます。

コードカスタマイズファイルの構成

1. [コンフィギュレーションパラメーター] ダイアログボックスを開きます。

3. ファイル example_file_process.tlc を開きます。

edit example_file_process.tlc

4. コードを生成する前に、コードの次の行がコメント解除されていることを確認します。

assign ERTCustomFileTest = TLC_TRUE

5. ファイル example_file_process.tlc を閉じます。

C++ コードとレポートの生成

1. C++ コードを生成するためにモデルを設定します。モデルコンフィギュレーションパラメーター [言語] を C++ に設定します。Embedded Coder を使用している場合、既定では、このパラメーター設定はモデルコンフィギュレーションパラメーター [コードインターフェイスのパッケージ化] の設定を C++ class に変更します。または、コマンドウィンドウで以下のように入力します。

set_param(model,'TargetLang','C++');

2. C++ コードおよびコード生成レポートを生成します。

evalc('slbuild(model)');

生成コードのレビュー

1. モデル MixedLanguagesAndLocales のコード生成レポートが開いていない場合は、コマンドウィンドウで次を入力します。

coder.report.open(model);

3. Embedded Coder を使用している場合はトレーサビリティレポートを開きます。このレポートでは、現在のエンコードで表現できない文字が名前に含まれている場合でも、トレーサビリティ情報が維持されます。モデル要素の名前は、ローカル言語に置換された名前としてレポートに現れます。

5. コードコメント内の <S2>:23 リンクをクリックします。モデルウィンドウの新しいタブにチャートが表示されます。

7. コード生成レポート、モデルアドバイザー、モデルを閉じます。コマンドウィンドウで以下のように入力します。

coder.report.close();
bdclose(model);