MATLAB Application Program Interface Reference

Create a 1-by-n character array initialized to the specified string

integer*4 function mxCreateString(str)
character*(*) str

Returns

A character array initialized to str if successful, 0 otherwise.

Arguments

str

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

Description

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

Free the character mxArray when you are finished using it. To free a character mxArray, call mxFreeMatrix.

[ Previous | Help Desk | Next ]