mxCreateCharArray(C)

N차원 mxChar 배열

C 구문

#include "matrix.h"
mxArray *mxCreateCharArray(mwSize ndim, const mwSize *dims);

설명

mxCreateCharArray를 사용하여 각 요소가 NULL로 설정된 N차원 mxChar 배열을 만듭니다.

MATLAB^®은 dims 인수에 지정된 후행 한원소 차원을 자동으로 제거합니다. 예를 들어 ndim이 5이고 dims가 [4 1 7 1 1]이면, 결과 배열은 4×1×7 차원을 갖습니다.

입력 인수

ndim — 차원 수

mwSize

차원 수로, mwSize로 지정됩니다. 0, 1 또는 2를 지정하면 mxCreateCharArray는 2차원 mxArray를 생성합니다.

dims — 차원 배열

const mwSize *

차원 배열로, const mwSize *로 지정됩니다.

차원 배열의 각 요소에는 해당 차원의 배열 크기가 들어 있습니다. 예를 들어 5×7 배열을 생성하려면, dims[0]을 5로, dims[1]을 7로 설정하십시오.

일반적으로 dims 배열에는 ndim개의 요소가 들어 있습니다.

출력 인수

pm — mxArray에 대한 포인터

mxArray * | NULL

mxChar 유형의 mxArray에 대한 포인터로, mxArray *로 지정됩니다.

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

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

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

버전 내역

R2006a 이전에 개발됨

참고 항목

mxCreateCharMatrixFromStrings | mxCreateString