ドキュメンテーション

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

Simulink.AliasType

信号およびパラメーターのデータ型のエイリアスの作成

説明

Simulink.AliasType を使用して、int8 などの組み込みのデータ型のエイリアスを作成します。

オブジェクトの名前はエイリアスです。エイリアスが参照する int8 などのデータ型は基本データ型です。

ベース ワークスペースまたはデータ ディクショナリにオブジェクトを作成します。エイリアスを使用するには、オブジェクトの名前を使用して、モデル内の信号、状態、およびパラメーターのデータ型を設定します。

エイリアスを使って信号やパラメーターのデータ型を指定すると、モデルが指定するデータ型をグローバルに変更することが非常に簡単になります。特に、データ型をエイリアスで指定したすべての信号、状態、およびパラメーターのデータ型を変更する場合、エイリアスの基本データ型を変更するだけで済みます。対照的に、データ型を実際のタイプ名で指定した信号、状態およびパラメーターのデータ型を変更するには、各信号、状態、およびパラメーターのデータ型を個々に指定し直す必要があります。

このクラスのオブジェクトでは、Simulink® の組み込みデータ型、固定小数点データ型、列挙データ型、Simulink.NumericType オブジェクト、他の Simulink.AliasType オブジェクトに対するエイリアスを作成できます。モデル (Simulink Coder™) から生成したコードでは、ERT ベース システムのターゲット ファイル (Embedded Coder®) を使用する場合にのみエイリアスを使用します。

または、数値データ型を定義して名前を付ける場合は、クラス Simulink.NumericType のオブジェクトを使用できます。

作成

データ型エイリアスはモデル エクスプローラーまたは MATLAB® コマンドを使用して作成できます。

モデル エクスプローラーを使用してエイリアスを作成するには、次の手順に従います。

  1. モデル エクスプローラーの [モデルの階層構造] ペインで [Base Workspace] を選択します。

    データ型エイリアスは MATLAB ワークスペースまたはデータ ディクショナリで作成しなければなりません。モデル ワークスペースでエイリアスを作成しようとすると、Simulink はエラーを表示します。

  2. モデル エクスプローラーの [追加] メニューから [Simulink.AliasType] を選択します。

    Simulink は、Simulink.AliasType オブジェクトのインスタンスを作成し、MATLAB ワークスペース内の Alias という名前の変数に割り当てます。

  3. 変数を適切な名前 (たとえば、使用目的を表す名前) に変更します。

    名前を変更するには、モデル エクスプローラーの [コンテンツ] ペインの [Name] フィールドに表示されている名前を編集します。

  4. モデル エクスプローラーの [ダイアログ] ペインの [基本型] フィールドに、このエイリアスが示すデータ型の名前を入力します。

    このフィールドには、既存の標準データ型またはユーザー定義の任意のデータ型を指定することができます。この手順は基本データ型が double (既定の設定) の場合は省略します。

外部 C コードの typedef ステートメントと一致する Simulink.AliasType オブジェクトを生成するには、関数 Simulink.importExternalCTypes を使用することを検討してください。

データ型のエイリアスをプログラムで作成するには、以下で説明する関数 Simulink.AliasType を使用します。

構文

aliasObj = Simulink.AliasType
aliasObj = Simulink.AliasType(baseType)

説明

aliasObj = Simulink.AliasType は、既定のプロパティ値をもつ Simulink.AliasType オブジェクトを返します。

aliasObj = Simulink.AliasType(baseType)Simulink.AliasType オブジェクトを返し、baseType を使用して BaseType プロパティの値を初期化します。

プロパティ

すべて展開する

Simulink.AliasType オブジェクトのプロパティ ダイアログ ボックスのプロパティの詳細については、Simulink.AliasType プロパティ ダイアログ ボックスを参照してください。

このエイリアスの名前が変更される基本データ型の名前。文字ベクトルとして指定します。int8 などの標準データ型の名前、または別の Simulink.AliasType オブジェクトの名前や列挙の名前などカスタム データ型の名前を指定できます。

固定小数点データ型を指定するには、'fixdt(0,16,7)' などの関数 fixdt の呼び出しを使用できます。

標準外のデータ型 (たとえば、Simulink.NumericType オブジェクトで定義されるデータ型) の指定は、1 つの例外を除き、データ型名の指定によって可能になります。その例外とは、Simulink.NumericTypeDataTypeMode[固定小数点: 未指定のスケーリング] の場合です。

メモ

[Fixed-point: unspecified scaling] は、Simulink.NumericType を使用するブロックによって定義が決まる部分的に指定されたタイプです。エイリアス タイプを使用しないようにすると、使用場所によって基本型が異なるエイリアスを作成しないようにできます。

プロパティ ダイアログ ボックスの [基本データ型] に対応します。

例: 'int8'

例: 'myOtherAlias'

データ型: char

生成されたコード (Simulink Coder) で型定義 (typedef) を生成またはインポートする指定。'Auto''Exported、または 'Imported' として指定します。

以下の表に、各オプションの影響を示します。

アクション
'Auto' (既定の設定)HeaderFile に値を指定しなかった場合、型定義を model_types.h にエクスポートします (model はモデル名)。Embedded Coder のライセンスがあり、データ型の置き換えが指定されている場合は、型定義を rtwtypes.h にエクスポートします。

HeaderFile に値が指定されている場合は、指定されたヘッダー ファイルからデータ型定義をインポートします。
'Exported'HeaderFile プロパティに指定可能なヘッダー ファイルに、データ型定義をエクスポートします。HeaderFile に値を指定しなかった場合、ヘッダー ファイル名の既定値は type.h になります (type はデータ型名)。
'Imported'HeaderFile プロパティに指定可能なヘッダー ファイルから、データ型定義をインポートします。HeaderFile に値を指定しなかった場合、ヘッダー ファイル名の既定値は type.h になります (type はデータ型名)。

詳細については、Control File Placement of Custom Data Types (Embedded Coder)を参照してください。

プロパティ ダイアログ ボックスの [データ スコープ] に対応します。

データ型エイリアスのカスタムの説明。文字ベクトルとして指定します。

プロパティ ダイアログ ボックスの [説明] に対応します。

例: 'This type alias corresponds to a floating-point implementation.'

データ型: char

生成されたコードの型定義 (typedef) を含むヘッダー ファイルの名前。文字ベクトルとして指定します。

このプロパティが指定されている場合、指定された名前は、インポートまたはエクスポートのコード生成時に使用されます。このプロパティが空の場合、値は DataScope'Imported' または 'Exported' の場合は type.h が既定に設定され、DataScope'Auto' の場合は model_types.h が既定に設定されます。

既定では、生成された #include 命令は、< および > の代わりに、プリプロセッサの区切り記号である " を使用します。命令 #include <myTypes.h> を生成するには、HeaderFile'<myTypes.h>' として指定します。

詳細については、Control File Placement of Custom Data Types (Embedded Coder)を参照してください。

プロパティ ダイアログ ボックスの [ヘッダー ファイル] に対応します。

例: 'myHdr.h'

例: 'myHdr'

例: 'myHdr.hpp'

データ型: char

すべて折りたたむ

SlDemoSign という列挙型のエイリアスを作成するには、次のように入力します。

myEnumAlias = Simulink.AliasType('Enum: SlDemoSign');

Simulink.AliasType オブジェクトを使用して固定小数点データ型のエイリアスを作成するには、関数 fixdt の呼び出しを使用してオブジェクトの BaseType プロパティを設定します。BaseType の値は、文字ベクトルとして指定しなければなりません。

たとえば、次のコードでは、語長が 16 で小数部の長さが 7 の符号なし固定小数点データ型のエイリアスが作成されます。

myFixptAlias = Simulink.AliasType;
myFixptAlias.BaseType = 'fixdt(0,16,7)';

R2006a より前に導入