matlab::cpplib::convertUTF8StringToUTF16String

Description

std::u16string & ustr convertUTF8StringToUTF16String(const std::string & str)

Convert a UTF-8 string (ASCII or Unicode^®) to a UTF-16 string. Use this function to convert ASCII strings into the form required to represent startup options (passed to initMATLABApplication), or function names or matlab::data::array.

Prefixing u to a literal char * string is a more concise alternative that achieves the same effect as convertUTF8StringToUTF16String when a literal string is passed as a parameter. For example, you could write initMATLABLibrary(app, u"mylib"); rather than the lengthier initMATLABLibrary(app, convertUTF8StringToUTF16String("mylib")); and get the same results.

Examples

auto app = initMATLABApplication(MATLABApplicationMode::IN_PROCESS);
const char * libName = getLibNameFromConfigFile(); // imaginary user-defined function
auto mylib = initMATLABLibrary(app, convertUTF8StringToUTF16String(libName));