isKey

ディクショナリがキーを含むかどうかを判別

R2022b 以降

構文

tf = isKey(d,key)

説明

tf = isKey(d,key) は、指定されたキーが設定済みディクショナリに含まれる場合に logical 1 (true) を返し、それ以外の場合に logical 0 (false) を返します。d が未設定のディクショナリの場合、isKey はエラーをスローします。

key が複数のキーを指定する配列である場合、tf は同じサイズの logical 配列です。

例

ディクショナリ内のキーの検索

複数のキーと値のペアを含むディクショナリを作成します。

names = ["Unicycle" "Bicycle" "Tricycle"];
wheels = [1 2 3];
d = dictionary(wheels,names)

d =

  dictionary (double ⟼ string) with 3 entries:

    1 ⟼ "Unicycle"
    2 ⟼ "Bicycle"
    3 ⟼ "Tricycle"

ディクショナリにキーとして 1 があるかどうかを判別します。

tf = isKey(d,1)

tf = logical
   1

複数のキーを検索します。

key = [1 2 3 4 5];
tf = isKey(d,key)

tf = 1×5 logical array

   1   1   1   0   0

入力引数

d — ディクショナリ

dictionary オブジェクト

ディクショナリ。dictionary オブジェクトとして指定します。d が未設定の場合、isKey はエラーをスローします。

key — キー セット

配列

キー セット。配列として指定します。key のデータ型は d 内のキーのデータ型と一致するか、これに変換可能でなければなりません。

拡張機能

C/C++ コード生成

MATLAB® Coder™ を使用して C および C++ コードを生成します。

使用上の注意および制限:

• コード ジェネレーターは、コード生成時にディクショナリが定数であっても、ディクショナリを定数として扱いません。これは、isKey 関数が定数を返さないことを意味します。定数入力を必要とする関数に isKey 関数の出力を渡すことはできません。isKey 関数の出力は、異種混合 cell 配列へのインデックス付けなど、定数を必要とする操作には使用できません。また、コード ジェネレーターは、isKey 関数の出力に対して、定数畳み込みなど、定数に依存する最適化を実行することもできません。

MATLAB^® ディクショナリの C/C++ コードを生成するときに適用されるその他の考慮事項については、コード生成におけるディクショナリの制限事項 (MATLAB Coder)を参照してください。

GPU コード生成

GPU Coder™ を使用して NVIDIA® GPU のための CUDA® コードを生成します。

使用上の注意および制限については、「C/C++ コード生成」セクションを参照してください。GPU コード生成にも同様の、使用上の注意および制限が適用されます。

バージョン履歴

R2022b で導入

R2024b: コード生成のサポート

ディクショナリ isKey 関数の C/C++ コードを生成できます。

参考

dictionary | configureDictionary | insert | lookup | remove | entries | keys | values | types | numEntries | isConfigured

トピック

• ディクショナリの作成と管理
• Manage Data Types in Dictionaries
• Use Dictionaries to Process Text Data