isConfigured

Determine if dictionary has types assigned to keys and values

Since R2022b

Syntax

tf = isConfigured(d)

Description

tf = isConfigured(d) returns a logical 1 (true) if the specified dictionary is configured, and it returns a logical 0 (false) if it is not. A dictionary is configured when it has types assigned to keys and values. When entries are added to an unconfigured dictionary, it becomes configured.

Examples

Determine if Dictionary is Configured

Create a dictionary and determine if it is configured.

d = dictionary;
tf = isConfigured(d)

tf = logical
   0

Now, create a dictionary that contains one key-value pair and determine if it is configured.

d = dictionary(1,"Blue");
tf = isConfigured(d)

tf = logical
   1

Input Arguments

d — Dictionary

dictionary object

Dictionary, specified as a dictionary object.

Tips

• A dictionary without entries can become configured by assigning empty arrays of the desired data type to the dictionary keys and values.

Extended Capabilities

C/C++ Code Generation

Generate C and C++ code using MATLAB® Coder™.

Usage notes and limitations:

• The code generator does not treat a dictionary as a constant, even if the dictionary is constant at code generation time. This means that the isConfigured function does not return a constant. You cannot pass the output of the isConfigured function to a function that requires constant inputs. You cannot use the output of the isConfigured function for operations that require constants, such as indexing into a heterogeneous cell array. The code generator also cannot perform optimizations that depend on constants, such as constant folding, on the output of the isConfigured function.

For additional considerations that apply when generating C/C++ code for MATLAB^® dictionaries, see Dictionary Limitations for Code Generation (MATLAB Coder).

Version History

Introduced in R2022b

R2024b: Code generation support

You can generate C/C++ code for the isConfigured function.