matlab::data::MATLABString

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<String>;

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::TypedArray<matlab::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<MATLABString>({ 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