mxCreateString(C)

지정된 문자열로 초기화된 1차원 배열

C 구문

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

설명

mxCreateString을 사용하여, str에서 초기화된 mxArray를 만듭니다.

mxArray 사용을 마치면 mxDestroyArray를 호출하십시오.

입력 인수

str — 문자열

const char *

문자열로, const char *로 지정됩니다. 이 문자열은 UTF-8을 사용하여 인코딩할 수 있습니다. 이전 버전과의 호환성을 위해 LCP(로컬 코드 페이지) 인코딩을 사용할 수도 있습니다.

출력 인수

pm — mxArray에 대한 포인터

mxArray * | NULL

mxArray에 대한 포인터로, mxArray *로 지정됩니다(성공하는 경우).

mxArray 생성을 위한 여유 힙 공간이 충분하지 않으면 이 함수는 실패합니다.

• MEX 파일 — 함수는 MEX 파일을 종료하고 제어를 MATLAB^® 프롬프트로 반환합니다.

• 독립 실행형(비 MEX 파일) 애플리케이션 — 함수는 NULL을 반환합니다.

예제

matlabroot/extern/examples/refbook에서 다음 예제를 참조하십시오.

• revord.c

matlabroot/extern/examples/mx에서 다음 예제를 참조하십시오.

• mxcreatestructarray.c

• mxisclass.c

버전 내역

R2006a 이전에 개발됨

R2020b: UTF-8 지원이 추가됨

mxCreateString 함수는 이제 이전 버전과의 호환성을 위해 LCP(로컬 코드 페이지) 인코딩 문자열을 지원하는 것 외에 UTF-8 인코딩 데이터를 받습니다.

참고 항목

mxCreateCharMatrixFromStrings | mxCreateCharArray