External Interfaces Reference |
Create populated two-dimensional char mxArray
Fortran Syntax
Arguments
m
The desired number of rows in the created string mxArray
. The value you specify for m
should equal the size of the str
array.
str
A Fortran character*n
array of size m
, where each element of the array is n
bytes.
Returns
A pointer to the created char mxArray
, if successful. If unsuccessful in a stand-alone (nonMEX-file) application, mxCreateCharMatrixFromStrings
returns 0
. If unsuccessful in a MEX-file, the MEX-file terminates, and control returns to the MATLAB prompt. Insufficient free heap space is the primary reason for mxCreateCharMatrixFromStrings
to be unsuccessful. Another possible reason for failure is that str
contains fewer than m
strings.
Description
Use mxCreateCharMatrixFromStrings
to create a two-dimensional string mxArray
, where each row is initialized to str
. The created mxArray
has dimensions m
-by-n
, where n
is the length of the number of characters in str(i)
.
See Also
mxCreateCharArray
, mxCreateString
mxCreateCharArray | mxCreateDoubleMatrix |
© 1994-2005 The MathWorks, Inc.