configureDictionary

R2026b

Create dictionary with specified key and value types

Since R2023b

Syntax

d = configureDictionary(keyType,valueType)

Description

d = configureDictionary(keyType,valueType) creates a dictionary with no entries that accepts keys of type keyType and values of type valueType.

Examples

Create Dictionary with Specified Key and Value Types

Create a dictionary that is configured to accept string keys and double values.

d = configureDictionary("string","double")

d =

  dictionary (string ⟼ double) with no entries.

Input Arguments

keyType — Key data type

string scalar | character vector

Key data type, specified as a string scalar or character vector.

valueType — Value data type

string scalar | character vector

Value data type, specified as a string scalar or character vector.

Tips

• The data type for keys and values must be a non-abstract class name or a subclass of matlab.mixin.Heterogeneous.

• If you specify char as the key type or value type, configureDictionary converts the type to string.

Extended Capabilities

C/C++ Code Generation

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

Usage notes and limitations:

• Code generation supports numeric, logical, half, character, and string data types as arguments to the configureDictionary function. You cannot use the configureDictionary function to configure dictionaries containing cells, structures, or user-defined objects.

• If you create a dictionary using configureDictionary, the dictionary cannot contain complex numbers as keys or values. To configure a dictionary that can contain complex numbers, use the dictionary function.

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

GPU Code Generation

Generate CUDA® code for NVIDIA® GPUs using GPU Coder™.

Refer to the usage notes and limitations in the C/C++ Code Generation section. The same usage notes and limitations apply to GPU code generation.

Version History

Introduced in R2023b

R2024b: Code generation support

You can generate C/C++ code for the configureDictionary function, with some limitations.