External Interfaces Reference

mxCreateString

Create 1-by-N string mxArray initialized to specified string

C Syntax

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

Arguments

str
   The C string that is to serve as the mxArray's initial data.

Returns

A pointer to the created string mxArray if successful, and NULL otherwise. The most likely cause of failure is insufficient free heap space.

Description

Use mxCreateString to create a string mxArray initialized to str. Many MATLAB functions (for example, strcmp and upper) require string array inputs.

Free the string mxArray when you are finished using it. To free a string mxArray, call mxDestroyArray.

Examples

See revord.c in the refbook subdirectory of the examples directory.

For additional examples, see mxcreatestructarray.c and mxisclass.c in the mx subdirectory of the examples directory.

See Also

mxCreateCharMatrixFromStrings, mxCreateCharArray

mxCreateSparseLogicalMatrix

mxCreateStructArray

© 1994-2005 The MathWorks, Inc.