lookup

キーによるディクショナリ内の値の検索

R2023b 以降

ページ内をすべて折りたたむ

    構文

    value = lookup(d,key)
    value = lookup(d,key,FallbackValue=fallback)

    説明

    value = lookup(d,key) は、dictionary d 内の key に対応する値を返します。key に対応するエントリがない場合、lookup はエラーをスローします。

    value = lookup(d,key) は value = d(key) と等価です。

    例

    value = lookup(d,key,FallbackValue=fallback) は、key が d で見つからない場合に返すフォールバック値を指定します。

    lookup 関数は、フォールバック値が必要な場合を除き、fallback を検証しません。エラーは、key が見つからない場合にのみスローされ、lookup が無効であっても発生しません。

    例

    例

    すべて折りたたむ

    ライブ スクリプトを開く

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

    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"

    値を検索します。

    v = lookup(d,1)
    v = 
"Unicycle"
    ライブ スクリプトを開く

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

    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"

    値が見つからない場合、フォールバック値を使用して値を検索します。

    v = lookup(d,[3,5],FallbackValue="Wheeled Vehicle")
    v = 1×2 string
    "Tricycle"    "Wheeled Vehicle"

    入力引数

    すべて折りたたむ

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

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

    フォールバック値。key が見つからない場合に返される値を含むスカラーとして指定します。fallback のデータ型は、d 内の値のデータ型と一致するか、これに変換可能でなければなりません。fallback は、key が見つからない場合を除き、検証されません。

    例: FallbackValue="Wheeled Vehicle"

    ヒント

    • ディクショナリでは、キーが値に要素単位でマッピングされるため、ベクトル化されたルックアップや挿入が行えるようになります。キーと値のそれぞれが同じデータ型または互換性のあるデータ型の要素で構成されていなければなりません。非スカラーまたは異種混合の値の格納には cell 配列を使用します。

    拡張機能

    すべて展開する

    バージョン履歴

    R2023b で導入

    すべて展開する

    参考

    | | | | | | | | | |

    トピック