mxCreateString (C)

1-D array initialized to specified string

C Syntax

#include "matrix.h"
mxArray *mxCreateString(const char *str);

Use mxCreateString to create an mxArray initialized from str.

Call mxDestroyArray when you finish using the mxArray.

String, specified as const char *. This string can be encoded using UTF-8 or, for backward compatibility, the local code page (LCP) encoding.

Pointer to an mxArray, specified as mxArray *, if successful.

The function is unsuccessful when there is not enough free heap space to create the mxArray.

MEX file — Function terminates the MEX file and returns control to the MATLAB^® prompt.
Standalone (non-MEX file) application — Function returns NULL.

See these examples in matlabroot/extern/examples/refbook:

See these examples in matlabroot/extern/examples/mx:

Introduced before R2006a

expand all

The mxCreateString function accepts UTF-8 encoded data in addition to supporting local code page (LCP) encoded strings for backward compatibility.