values

Values of dictionary

Since R2022b

Syntax

v = values(d)

v = values(d,"cell")

Description

v = values(d) returns an array containing the values of the specified dictionary.

v = values(d,"cell") optionally return the values as a cell array.

Examples

Query Values of Dictionary

Create a dictionary containing three key-value pairs that map numbers to strings.

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"

Use values to return an array containing the values stored in the dictionary.

v = values(d)

v = 3x1 string
    "Unicycle"
    "Bicycle"
    "Tricycle"

Return Values of Dictionary as Cell Array

Create a dictionary containing three key-value pairs that map numbers to strings.

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"

Use values to return an array containing the values stored in the dictionary as a cell array.

v = values(d,"cell")

v=3×1 cell array
    {["Unicycle"]}
    {["Bicycle" ]}
    {["Tricyle" ]}

Input Arguments

d — Dictionary

dictionary object

Dictionary, specified as a dictionary object. If d is unconfigured, values throws an error.

Version History

Introduced in R2022b