mxCreateString (Fortran)

1-N массив, инициализированный в указанную строку

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

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

Описание

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

mxCreateString поддерживает как многобайтовые, так и однобайтовые кодированные символы. В Windows® и Linux® платформы, установка локализации задаёт кодировку по умолчанию.

Звонить mxDestroyArray когда вы заканчиваете использовать mxArray.

Входные параметры

расширить все

Строка, заданная как character*(*). Поддерживаются только символы ASCII.

Выходные аргументы

расширить все

Указатель на mxArray типа mxChar, заданный как mwPointer, в случае успеха.

Функция неудачна, когда не хватает свободного пространства в куче, чтобы создать mxArray.

  • Файл MEX - Function завершает Файл MEX и возвращает управление в подсказку MATLAB.

  • Автономное (не-MEX файл) приложение - Функция возвращает 0.

Примеры

См. эти примеры в matlabroot/ extern/examples/refbook:

См. эти примеры в matlabroot/ extern/examples/eng_mat:

Представлено до R2006a