External Interfaces/API Reference

mxCreateCharMatrixFromStrings

Create a populated two-dimensional char mxArray

Fortran Syntax

• integer*4 function mxCreateCharMatrixFromStrings(m, str)
  integer*4 m
  character*(*) str(m)
  

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