entries

ディクショナリのキーと値のペア

R2022b 以降

構文

E = entries(d)

E = entries(d,format)

説明

E = entries(d) は、指定されたディクショナリのキーと値のペアを含む table を返します。

E = entries(d,format) は、出力の format を table または構造体として指定します。たとえば、entries(d,"struct") は d のキーと値のペアを含む構造体を返します。このオプションは、table と互換性のないデータ型の場合に使用します。

例

ディクショナリのエントリ

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

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

d =

  dictionary (double --> string) with 3 entries:

    1 --> "Unicycle"
    2 --> "Bicycle"
    3 --> "Tricyle"

entries を使用して、d に格納されているエントリを含む table を返します。

E = entries(d)

E=3×2 table
    Key      Value   
    ___    __________

     1     "Unicycle"
     2     "Bicycle" 
     3     "Tricyle" 

構造体としてのディクショナリのエントリ

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

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

d =

  dictionary (double --> string) with 3 entries:

    1 --> "Unicycle"
    2 --> "Bicycle"
    3 --> "Tricyle"

entries を使用して出力形式を "struct" として指定し、d に格納されているエントリを含む struct 配列を返します。

E = entries(d,"struct")

E=3×1 struct array with fields:
    Key
    Value

入力引数

d — ディクショナリ

dictionary オブジェクト

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

format — 出力形式

"table" (既定値) | "struct" | "cell"

出力形式。次の値のいずれかとして指定します。

• "table" — キーと値のペアを table に返します。この形式は既定の出力形式です。

• "struct" — n 行 1 列の struct 配列を返します。ここで、n 個の struct 要素にはそれぞれ、指定されたディクショナリ内の n 個の各エントリに対応するフィールド key および value があります。このオプションは、table と互換性のないデータ型の場合に使用します。

• "cell" — キーと値のペアを n 行 2 列の cell 配列に返します。ここで、n はエントリ数で、1 列目にはキーが含まれ、2 列目には値が含まれます。

バージョン履歴

R2022b で導入

参考

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