アプリを使用した入力パラメーターの型の定義または編集

入力パラメーターの型の定義または編集

次の手順では、double、single、int64、int32、int16、int8、uint64、uint32、uint16、uint8、logical および char 型を定義または編集する方法について示します。

他の型の定義の詳細については、次の表を参照してください。

入力の型	リンク
string スカラー (1 行 1 列の string 配列)	string スカラーの入力パラメーターの指定
構造体 (struct)	構造体入力パラメーターの指定
cell 配列 (cell (Homogeneous) または cell (Heterogeneous))	cell 配列の入力パラメーターの指定
固定小数点データ型 (embedded.fi)	固定小数点入力パラメーターの指定
定数 (定数の定義)	定数入力パラメーターの指定
列挙型	列挙型入力パラメーターの指定
グローバル変数	アプリを使用したグローバル変数の型と初期値の指定
値クラスオブジェクト	MATLAB Coder アプリでの入力としてのオブジェクトの指定
例による入力 (例で定義)	アプリを使用した例による入力パラメーターの定義
入力の型の自動定義が行われる入力	アプリを使用した入力の型の自動定義

入力パラメーター名の右にあるフィールドをクリックします。
オプションで、数値型については、[複素数] チェックボックスを選択してパラメーターを複素数型にします。
入力の型を選択します。
選択した型が表示されます。サイズオプションが表示されます。
一覧にある、スカラー、1 x n ベクトル、m x 1 ベクトル、m x n 行列から、入力に当てはまるものを選択します。既定では、サイズオプションを選択しなかった場合、アプリは入力をスカラーとして定義します。
オプションで、入力がスカラーでない場合、サイズ m と n を入力します。以下を指定できます。
- 10 などの固定サイズ。
- 指定された制限までの可変サイズ。: プレフィックスを使用します。たとえば、最大 10 の可変サイズであることを指定するには、:10 を入力します。
- 制限なしの可変サイズは、:Inf を入力します。
各次元のサイズを編集できます。

string スカラーの入力パラメーターの指定

入力が string スカラーであることを指定するには、次のようにします。

[入力の型を定義] ページで [入力またはグローバルの型を直接入力します] をクリックします。
定義する入力パラメーターの右側のフィールドをクリックします。
[string] を選択します。次に、1x1 scalar を選択します。
この型は文字ベクトルを含む 1 行 1 列の string 配列 (string スカラー) です。
文字ベクトルのサイズを指定するには、string 配列の要素 {1} の右にあるフィールドをクリックします。[char] を選択します。次に、1xn vector を選択してサイズを入力します。
string を可変サイズにするには、2 番目の次元をクリックします。
- 2 番目の次元が無制限であることを指定するには、:Inf を選択します。
- 2 番目の次元に上限があることを指定するには、8 などの上限を入力します。次に、:8 を選択します。

列挙型入力パラメーターの指定

入力が列挙型 MyColors を使用することを指定するには次の手順に従ってください。

MATLAB^® パスに列挙型 MyColors があると仮定します。

classdef MyColors < int32
    enumeration
        green(1),
        red(2),
    end
end

[入力の型を定義] ページで [入力またはグローバルの型を直接入力します] をクリックします。
入力パラメーターの右にあるフィールドに MyColors と入力します。

固定小数点入力パラメーターの指定

固定小数点入力を指定するには、Fixed-Point Designer™ ソフトウェアがインストールされていなければなりません。

[入力の型を定義] ページで [入力またはグローバルの型を直接入力します] をクリックします。
定義する入力パラメーターの右側のフィールドをクリックします。
[embedded.fi] を選択します。
サイズを選択します。サイズを指定しない場合、サイズは既定の設定で 1 行 1 列になります。
入力パラメーター numerictype (Fixed-Point Designer) および fimath (Fixed-Point Designer) プロパティを指定します。
ローカル fimath を指定しない場合、アプリは既定の fimath を使用します。既定の fimath を使用した演算規則の共有 (Fixed-Point Designer)を参照してください。

numerictype (Fixed-Point Designer) または fimath (Fixed-Point Designer) プロパティを変更するには、[プロパティ] ダイアログボックスを開きます。[プロパティ] ダイアログボックスを開くには、固定小数点型の定義の右側をクリックします。オプションで、をクリックします。

構造体入力パラメーターの指定

基本入力が構造体のときは、アプリでは各フィールドが個別の入力として扱われます。そのため、基本構造体入力のすべてのフィールドに対して、構造体の定義で指定されている順番で、プロパティを指定しなければなりません。

入力構造体の各フィールドに、クラス、サイズおよび実数/複素数を指定します。
また、固定小数点クラスである各フィールドに numerictype と fimath を指定します。

型による構造体の指定

[入力の型を定義] ページで [入力またはグローバルの型を直接入力します] をクリックします。
定義する入力パラメーターの右側のフィールドをクリックします。
[struct] を選択します。
選択した型 struct が表示されます。また、サイズオプションが表示されます。
スカラー、1 x n ベクトル、m x 1 ベクトル、m x n 行列から、構造体に当てはまるものを指定します。既定では、サイズオプションを選択しなかった場合、アプリは入力をスカラーとして定義します。
入力がスカラーでない場合、各次元のサイズを入力します。次元をクリックします。サイズを入力します。サイズのオプションから選択します。たとえば、サイズが 10 の場合は次を行います。
- 固定サイズを指定するには、10 を選択します。
- 上限が 10 の可変サイズを指定するには、:10 を選択します。
- 制限なしの可変サイズを指定するには、:Inf を選択します。
オプションで、生成されたコード内の構造体のプロパティを指定します。構造体のプロパティの設定を参照してください。
構造体にフィールドを追加します。フィールドのクラス、サイズおよび実数/複素数を指定します。構造体へのフィールドの追加を参照してください。

構造体のプロパティの設定

構造体の定義の右側をクリックします。オプションで、をクリックします。

ダイアログボックスで、生成されたコード内の構造体のプロパティを指定します。

プロパティ	説明
C の型定義名	生成されたコード内の構造体型の名前。
型定義は外部で定義されます	既定の設定: `[いいえ]` — 型定義は外部で定義されません。 `[はい]` を選択して外部で定義された構造体を宣言する場合、アプリは構造体の型の定義を生成しません。カスタムのインクルードファイル内で型を定義しなければなりません。依存関係: `[C の型定義名]` でこのオプションは有効になります。
C の型定義のヘッダーファイル	構造体の外部定義を含むヘッダーファイルの名前 (`"mystruct.h"` など)。[プロジェクトの設定] ダイアログボックスの [カスタムコード] タブにある [追加インクルードディレクトリ] パラメーターを使用して、ファイルへのパスを指定します。既定では、生成されたコードには、標準ヘッダーファイルの後にカスタムヘッダーファイル用の `#include` ステートメントが含まれます。標準ヘッダーファイルがカスタムの構造体型を参照している場合は、コンパイルが失敗します。[C の型定義のヘッダーファイル] を指定することで、アプリはヘッダーファイルが必要とされる正確な場所にファイルをインクルードします。依存関係: このオプションは、`[型定義は外部で定義されます]` が `[はい]` に設定されている場合に有効になります。
データ整列境界	この型の構造体での実行時のメモリ配置 (バイト単位)。 Embedded Coder^® ライセンスをお持ちの場合、コード置換ライブラリ (CRL) を使用している場合は、置換関数に渡したデータオブジェクトを指定の境界に配置する機能が CRL によって提供されます。整列したデータを必要とするターゲット固有の関数実装を活用できます。既定では、構造体は特定の境界に配置されないため、アライメントを必要とする CRL の関数とは一致しません。配置は `-1` または `2` のべき乗のいずれかで、`128` 以下でなければなりません。既定値: `0` 依存関係: このオプションは、`[型定義は外部で定義されます]` が `[はい]` に設定されている場合に有効になります。

構造体のフィールド名の変更

名前を変更する構造体の名前フィールドを選択します。新しい名前を入力します。

構造体へのフィールドの追加

構造体の右にあるをクリックします。
フィールド名を入力します。フィールドのクラス、サイズおよび実数/複素数を指定します。

構造体へのフィールドの挿入

下に別のフィールドを追加しようとしている構造体フィールドを選択します。
構造体フィールドを右クリックします。
[下にフィールドを挿入] を選択します。
選択したフィールドの後にフィールドが追加されます。
フィールド名を入力します。フィールドのクラス、サイズおよび実数/複素数を指定します。

構造体からのフィールドの削除

削除するフィールドを右クリックします。
[フィールドの削除] を選択します。

cell 配列の入力パラメーターの指定

コード生成では、cell 配列は同種または異種混合になります。cell 配列のコード生成を参照してください。同種 cell 配列は生成されたコード内で配列として表されます。すべての要素のプロパティは同じになります。異種混合 cell 配列は生成されたコード内で構造体として表されます。要素は異なるプロパティをもつことができます。

同種 cell 配列の指定

[入力の型を定義] ページで [入力またはグローバルの型を直接入力します] をクリックします。
定義する入力パラメーターの右側のフィールドをクリックします。
[cell (Homogeneous)] を選択します。
選択した型 cell が表示されます。また、サイズオプションが表示されます。
一覧にある、スカラー、1 x n ベクトル、m x 1 ベクトル、m x n 行列から、入力に当てはまるものを選択します。既定では、サイズオプションを選択しなかった場合、アプリは入力をスカラーとして定義します。
入力がスカラーでない場合、各次元のサイズを入力します。次元をクリックします。サイズを入力します。サイズのオプションから選択します。たとえば、サイズが 10 の場合は次を行います。
- 固定サイズを指定するには、10 を選択します。
- 上限が 10 の可変サイズを指定するには、:10 を選択します。
- 制限なしの可変サイズを指定するには、:Inf を選択します。
cell 配列変数の下の、中かっこ内のコロン {:} は、cell 配列要素が同じプロパティ (クラス、サイズおよび実数/複素数) をもっていることを示しています。
cell 配列の要素のクラス、サイズおよび実数/複素数を指定するには、{:} の右にあるフィールドをクリックします。

異種混合 cell 配列の指定

[入力の型を定義] ページで [入力またはグローバルの型を直接入力します] をクリックします。
定義する入力パラメーターの右側のフィールドをクリックします。
[cell (Heterogeneous)] を選択します。
選択した型 cell が表示されます。また、サイズオプションが表示されます。
スカラー、1 x n ベクトル、m x 1 ベクトル、m x n 行列から、構造体に当てはまるものを指定します。既定では、サイズオプションを選択しなかった場合、アプリは入力をスカラーとして定義します。
オプションで、入力がスカラーでない場合、サイズ m と n を入力します。異種混合 cell 配列は固定サイズです。
cell 配列の要素が一覧表示されます。インデックス表記を使用して各要素を指定します。たとえば、{1,2} は行 1、列 2 の要素を示しています。
各 cell 配列の要素のクラス、サイズおよび実数/複素数を指定します。
オプションで、要素を追加します。異種混合 cell 配列への要素の追加を参照してください。
オプションで、生成されたコード内の cell 配列を表す構造体のプロパティを指定します。異種混合 cell 配列の構造体プロパティの設定を参照してください。

異種混合 cell 配列の構造体プロパティの設定

異種混合 cell 配列は生成されたコード内で構造体として表されます。cell 配列を表す構造体のプロパティを指定できます。

cell 配列定義の右側をクリックします。オプションで、をクリックします。

ダイアログボックスで、生成されたコード内の構造体のプロパティを指定します。

プロパティ	説明
C の型定義名	生成されたコード内の構造体型の名前。
型定義は外部で定義されます	既定の設定: `[いいえ]` — 型定義は外部で定義されません。 `[はい]` を選択して外部で定義された構造体を宣言する場合、アプリは構造体の型の定義を生成しません。カスタムのインクルードファイル内で型を定義しなければなりません。依存関係: `[C の型定義名]` でこのオプションは有効になります。
C の型定義のヘッダーファイル	構造体の外部定義を含むヘッダーファイルの名前 (`"mystruct.h"` など)。[プロジェクトの設定] ダイアログボックスの [カスタムコード] タブにある [追加インクルードディレクトリ] パラメーターを使用して、ファイルへのパスを指定します。既定では、生成されたコードには、標準ヘッダーファイルの後にカスタムヘッダーファイル用の `#include` ステートメントが含まれます。標準ヘッダーファイルがカスタムの構造体型を参照している場合は、コンパイルが失敗します。[C の型定義のヘッダーファイル] を指定することで、アプリはヘッダーファイルが必要とされる正確な場所にファイルをインクルードします。依存関係: このオプションは、`[型定義は外部で定義されます]` が `[はい]` に設定されている場合に有効になります。
データ整列境界	この型の構造体での実行時のメモリ配置 (バイト単位)。 Embedded Coder ライセンスをお持ちの場合、コード置換ライブラリ (CRL) を使用している場合は、置換関数に渡したデータオブジェクトを指定の境界に配置する機能が CRL によって提供されます。整列したデータを必要とするターゲット固有の関数実装を活用できます。既定では、構造体は特定の境界に配置されないため、アライメントを必要とする CRL の関数とは一致しません。配置は `-1` または `2` のべき乗のいずれかで、`128` 以下でなければなりません。既定値: `0` 依存関係: このオプションは、`[型定義は外部で定義されます]` が `[はい]` に設定されている場合に有効になります。

同種または異種混合としての分類の変更

同種または異種混合としての分類を変更するには、変数を右クリックします。[同種] または [異種混合] を選択します。

アプリで、要素の定義がクリアされます。

cell 配列のサイズの変更

cell 配列の定義で、次元をクリックします。サイズを指定します。
同種 cell 配列の場合は、次元が可変サイズかどうかおよび次元が制限されているかどうかを指定します。または、変数を右クリックします。[制限あり (固定サイズ)]、[制限あり (可変サイズ)] または [制限なし] を選択します。
異種混合 cell 配列の場合、cell 配列に指定されたサイズと形状が含まれるようにアプリによって要素が追加されます。

異種混合 cell 配列への要素の追加

cell 配列の定義で、次元をクリックします。サイズを指定します。たとえば、最初の次元には 1、2 番目の次元には 4 を入力します。
cell 配列に指定されたサイズと形状が含まれるように、アプリによって要素が追加されます。たとえば、1 行 4 列の異種混合 cell 配列の場合、アプリでは {1,1}、{1,2}、{1,3} および {1,4} の 4 つの要素が一覧表示されます。
新しい要素のプロパティを指定します。

定数入力パラメーターの指定

[入力の型を定義] ページで [入力またはグローバルの型を直接入力します] をクリックします。
入力パラメーター名の右にあるフィールドをクリックします。
[定数の定義] を選択します。
パラメーター名の右にあるフィールドに、定数値または定数を表す MATLAB 式を入力します。
アプリは、指定された MATLAB 式の値をコンパイル時の定数として使用します。

参考

MATLAB Coder