mxArrayToString(C)

배열을 문자열로

C 구문

#include "matrix.h"
char *mxArrayToString(const mxArray *array_ptr);

설명

mxArrayToString을 호출하여 mxCHAR 배열의 문자형 데이터를 C 스타일 문자열로 복사합니다. C 스타일 문자열은 항상 NULL 문자로 종결되고, 열 우선 순서로 저장됩니다. 배열에 행이 여러 개 있으면 행은 단일 배열에 열 방향 복사됩니다.

이 함수는 다음을 제외하고는 mxGetString과 유사합니다.

• mxArrayToString에는 입력값으로 문자열의 길이가 필요하지 않습니다.

• R2022a부터 mxArrayToString은 UTF-8 인코딩 문자열을 반환합니다.

입력 인수

array_ptr — mxCHAR 배열에 대한 포인터

const mxArray *

mxCHAR 배열에 대한 포인터로, const mxArray *로 지정됩니다.

출력 인수

str — C 스타일 문자열

char * | NULL

LCP(로컬 코드 페이지) 인코딩으로 작성된 C 스타일 문자열로, char *로 지정됩니다. 배열을 UTF-8 인코딩으로 작성된 문자열로 변환하려면 mxArrayToUTF8String을 사용하십시오.

실패 시 NULL을 반환합니다. 가능한 실패 원인으로는 메모리가 부족하거나 지정하는 배열이 mxCHAR 배열이 아닌 경우 등입니다.

예제

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

• mexatexit.c

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

• mxcreatecharmatrixfromstr.c

버전 내역

R2006a 이전에 개발됨

참고 항목

mxCreateString | mxGetString | mxArrayToUTF8String | mxCreateCharArray | mxCreateCharMatrixFromStrings