matlab::data::MATLABString - Element type for MATLAB string arrays - MATLAB (original) (raw)

Main Content

Element type for MATLAB string arrays

Description

Use MATLABString to represent MATLAB® string arrays in C++. To be able to represent missing string array elements, MATLABString is defined as:

using MATLABString = optional;

For more information on string arrays in MATLAB, see Create String Arrays.

Class Details

Namespace: matlab::data
Include: String.hpp

Examples

Pass String Array from MATLAB to MEX function

Create a string array in MATLAB and pass it to a C++ MEX function:

str(1) = ""; str(2) = "Gemini"; str(3) = string(missing) result = myMexFcn(str);

In the MEX function, assign the input to an array of type matlab::data::MATLABString.

matlab::data::TypedArraymatlab::data::MATLABString stringArray = inputs[0];

Pass String Array from MEX function to MATLAB

Create a string array in the MEX function and pass this array to MATLAB as output. The array defines text elements, an empty string, and a missing string element.

matlab::data::ArrayFactory factory; outputs[0] = factory.createArray({ 1,3 }, { matlab::data::MATLABString(u""), matlab::data::MATLABString(u"Gemini"), matlab::data::MATLABString() });

The result returned to MATLAB is a string array.

result =

1×3 string array

""    "Gemini"    <missing>

Version History

Introduced in R2017b