Синтаксис C

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

Синтаксис языка ФОРТРАН

#include "fintrf.h"
mwPointer mxCreateString(str)
character*(*) str

Аргументы

Возвращается

Указатель на созданный mxArray, в случае успеха. Если неудачный в автономном (нефайл MEX) приложение, возвращает NULL в C (0 на Фортране). Если неудачный в файле MEX, файл MEX отключает и возвращает управление в подсказку ^MATLAB®. Функция неудачна, когда существует недостаточно свободного пространства "кучи", чтобы создать mxArray.

Описание

Используйте mxCreateString, чтобы создать mxArray, инициализированный к str. Много функций MATLAB (например, strcmp и upper) требуют входных параметров массива строк.

mxCreateString поддерживает и многобайтовые и однобайтовые закодированные символы. На ^Windows® и платформах ^Linux®, пользовательская установка локали задает кодировку по умолчанию.

Освободите mxArray, когда вы будете закончены с помощью него путем вызова mxDestroyArray.

Примеры

См. следующие примеры в matlabroot / extern / examples / refbook.

См. следующие примеры в matlabroot / extern / examples / mx.

См. следующие примеры в matlabroot / extern / examples / eng_mat.

Смотрите также

mxCreateCharMatrixFromStrings, mxCreateCharArray