C Matrix API

C Matrix API를 사용하여 mxArray 유형을 사용해 MATLAB 데이터를 나타내는 C 프로그램 생성

MATLAB^® R2017b 이하 버전에서 작동하는 C 프로그램을 작성하려면 C Matrix API의 함수를 사용하십시오. 이러한 함수는 mxArray 데이터 구조와 호환되는 C MEX 함수 또는 C 엔진 애플리케이션을 작성하는 데 사용됩니다.

참고

가능하면 C 애플리케이션보다 C++ 애플리케이션을 선택합니다.

C Matrix API는 두 가지 버전이 있습니다.

MATLAB R2018a에는 실수부/허수부 결합형 복소수 API에 C Matrix API 기능이 포함되어 있습니다. 자세한 내용은 MATLAB Support for Interleaved Complex API in MEX Functions 항목을 참조하십시오.
MATLAB R2017b에는 실수부/허수부 분리형 복소수 API에 C Matrix API 기능이 포함되어 있습니다.

이러한 라이브러리 함수를 사용하는 예제를 보려면 다음 항목을 참조하십시오.

MEX 함수의 소스 코드 예제 표
MAT 파일의 소스 코드 파일 표
예제 정보는 개별 함수에서 참조하십시오. 예를 들어 mxIsChar을 참조하십시오.

주의

C Matrix API는 최신 C++ 기능을 지원하는 C++용 MATLAB Data API와 호환되지 않습니다. C Matrix API의 함수는 MATLAB에서 호출 가능한 C++ 함수 작성하기(MEX 파일) 또는 C++에서 MATLAB 호출하기에 설명된 MATLAB API의 함수와 함께 사용할 수 없습니다.

C 데이터형

`mxArray`	MATLAB 배열에 대한 C 유형
`mwSize`	mxArray 크기 값의 C 유형
`mwIndex`	mxArray 인덱스 값에 대한 C 유형
`mwSignedIndex`	mxArray 크기 값의 부호 있는 정수 C 유형
`mxChar`	Type for string array
`mxLogical`	논리형 배열의 유형
`mxComplexity`	배열에 허수부가 있는지를 지정하는 플래그

mxArray 특성

`mxIsNumeric`	Determine whether mxArray is numeric
`mxIsComplex`	Determine whether data is complex
`mxGetNumberOfDimensions`	mxArray의 차원 수
`mxGetElementSize`	Number of bytes required to store each data element
`mxGetDimensions`	차원 배열에 대한 포인터
`mxSetDimensions`	Modify number of dimensions and size of each dimension
`mxGetNumberOfElements`	숫자형 mxArray의 요소 개수
`mxCalcSingleSubscript`	Offset from first element to desired element
`mxGetM`	mxArray의 행 개수
`mxSetM`	mxArray의 행 개수 설정
`mxGetN`	mxArray의 열 개수
`mxSetN`	mxArray의 열 개수 설정
`mxIsEmpty`	Determine whether mxArray is empty
`mxIsFromGlobalWS`	Determine whether mxArray was copied from MATLAB global workspace

데이터형 만들기, 쿼리 및 액세스하기

모두 확장

숫자형

`mxCreateDoubleMatrix`	2차원, 배정밀도, 부동소수점 배열
`mxCreateDoubleScalar`	지정된 값으로 초기화되는 스칼라 배정밀도 배열
`mxCreateNumericMatrix`	2차원 숫자형 행렬
`mxCreateNumericArray`	N차원 숫자형 배열
`mxCreateUninitNumericMatrix`	Uninitialized 2-D numeric matrix
`mxCreateUninitNumericArray`	Uninitialized N-D numeric array

비복소수형 부동소수점

`mxIsScalar`	Determine whether array is scalar array
`mxGetScalar`	Real component of first data element in array
`mxIsDouble`	Determine whether mxArray represents data as double-precision, floating-point numbers
`mxGetDoubles`	`mxDOUBLE_CLASS` 배열의 실수 데이터 요소
`mxSetDoubles`	`mxDOUBLE_CLASS` 배열에 실수 데이터 요소 설정
`mxIsSingle`	Determine whether mxArray represents data as single-precision, floating-point numbers
`mxGetSingles`	`mxSINGLE_CLASS` 배열의 실수 데이터 요소
`mxSetSingles`	Set real data elements in `mxSINGLE_CLASS` array
`mxGetPr`	(권장되지 않음) `mxDOUBLE_CLASS` 배열의 실수 데이터 요소
`mxSetPr`	(Not recommended) Set real data elements in `mxDOUBLE_CLASS` array

비복소수형 정수

`mxIsInt8`	Determine whether mxArray represents data as signed 8-bit integers
`mxGetInt8s`	`mxINT8_CLASS` 배열의 실수 데이터 요소
`mxSetInt8s`	Set real data elements in `mxINT8_CLASS` array
`mxIsUint8`	Determine whether mxArray represents data as unsigned 8-bit integers
`mxGetUint8s`	`mxUINT8_CLASS` 배열의 실수 데이터 요소
`mxSetUint8s`	Set real data elements in `mxUINT8_CLASS` array
`mxIsInt16`	Determine whether mxArray represents data as signed 16-bit integers
`mxGetInt16s`	`mxINT16_CLASS` 배열의 실수 데이터 요소
`mxSetInt16s`	Set real data elements in `mxINT16_CLASS` array
`mxIsUint16`	Determine whether mxArray represents data as unsigned 16-bit integers
`mxGetUint16s`	`mxUINT16_CLASS` 배열의 실수 데이터 요소
`mxSetUint16s`	Set real data elements in `mxUINT16_CLASS` array
`mxIsInt32`	Determine whether mxArray represents data as signed 32-bit integers
`mxGetInt32s`	`mxINT32_CLASS` 배열의 실수 데이터 요소
`mxSetInt32s`	Set real data elements in `mxINT32_CLASS` array
`mxIsUint32`	Determine whether mxArray represents data as unsigned 32-bit integers
`mxGetUint32s`	`mxUINT32_CLASS` 배열의 실수 데이터 요소
`mxSetUint32s`	Set real data elements in `mxUINT32_CLASS` array
`mxIsInt64`	Determine whether mxArray represents data as signed 64-bit integers
`mxGetInt64s`	`mxINT64_CLASS` 배열의 실수 데이터 요소
`mxSetInt64s`	Set data elements in `mxINT64_CLASS` array
`mxIsUint64`	Determine whether mxArray represents data as unsigned 64-bit integers
`mxGetUint64s`	`mxUINT64_CLASS` 배열의 실수 데이터 요소
`mxSetUint64s`	Set real data elements in `mxUINT64_CLASS` array

복소수형 부동소수점

`mxGetComplexDoubles`	`mxDOUBLE_CLASS` 배열의 복소수 데이터 요소
`mxSetComplexDoubles`	Set complex data elements in `mxDOUBLE_CLASS` array
`mxGetComplexSingles`	`mxSINGLE_CLASS` 배열의 복소수 데이터 요소
`mxSetComplexSingles`	Set complex data elements in `mxSINGLE_CLASS` array
`mxGetImagData`	Imaginary data elements in numeric `mxArray`
`mxSetImagData`	Set imaginary data elements in numeric `mxArray`
`mxGetPi`	(Not recommended) Imaginary data elements in `mxDOUBLE_CLASS` array
`mxSetPi`	(Not recommended) Set imaginary data elements in `mxDOUBLE_CLASS` array

복소수형 정수

`mxGetComplexInt8s`	Complex data elements in `mxINT8_CLASS` array
`mxSetComplexInt8s`	Set complex data elements in `mxINT8_CLASS` array
`mxGetComplexUint8s`	Complex data elements in `mxUINT8_CLASS` array
`mxSetComplexUint8s`	Set complex data elements in `mxUINT8_CLASS` array
`mxGetComplexInt16s`	Complex data elements in `mxINT16_CLASS` array
`mxSetComplexInt16s`	Set complex data elements in `mxINT16_CLASS` array
`mxGetComplexUint16s`	Complex data elements in `mxUINT16_CLASS` array
`mxSetComplexUint16s`	Set complex data elements in `mxUINT16_CLASS` array
`mxGetComplexInt32s`	Complex data elements in `mxINT32_CLASS` array
`mxSetComplexInt32s`	Set complex data elements in `mxINT32_CLASS` array
`mxGetComplexUint32s`	Complex data elements in `mxUINT32_CLASS` array
`mxSetComplexUint32s`	Set complex data elements in `mxUINT32_CLASS` array
`mxGetComplexInt64s`	Complex data elements in `mxINT64_CLASS` array
`mxSetComplexInt64s`	Set complex data elements in `mxINT64_CLASS` array
`mxGetComplexUint64s`	Complex data elements in `mxUINT64_CLASS` array
`mxSetComplexUint64s`	Set complex data elements in `mxUINT64_CLASS` array
`mxGetPi`	(Not recommended) Imaginary data elements in `mxDOUBLE_CLASS` array
`mxSetPi`	(Not recommended) Set imaginary data elements in `mxDOUBLE_CLASS` array

희소 형식

`mxCreateSparse`	2-D sparse array
`mxCreateSparseLogicalMatrix`	2-D, sparse, logical array
`mxIsSparse`	Determine whether input is sparse mxArray
`mxGetNzmax`	Number of elements in IR, PR, and PI arrays
`mxSetNzmax`	Set storage space for nonzero elements
`mxGetIr`	Sparse matrix IR array
`mxSetIr`	IR array of sparse array
`mxGetJc`	Sparse matrix JC array
`mxSetJc`	JC array of sparse array

비숫자형

`mxGetData`	숫자형이 아닌 `mxArray`의 데이터 요소
`mxSetData`	Set pointer to data elements in nonnumeric `mxArray`

문자형

`mxCreateString`	지정된 문자열로 초기화된 1차원 배열
`mxCreateCharMatrixFromStrings`	2-D `mxChar` array initialized to specified value
`mxCreateCharArray`	N차원 `mxChar` 배열
`mxIsChar`	Determine whether input is `mxChar` array
`mxGetChars`	문자형 배열 데이터에 대한 포인터

논리형

`mxIsLogical`	Determine whether mxArray is of type `mxLogical`
`mxIsLogicalScalar`	Determine whether scalar array is of type mxLogical
`mxIsLogicalScalarTrue`	Determine whether scalar array of type mxLogical is true
`mxClassID`	배열의 클래스를 식별하는 열거형 값
`mxCreateLogicalArray`	N-D logical array
`mxCreateLogicalMatrix`	2-D logical array
`mxCreateLogicalScalar`	Scalar, logical array
`mxGetLogicals`	Pointer to logical array data

객체

`mxIsClass`	Determine whether mxArray is object of specified class
`mxGetClassID`	Class of mxArray
`mxGetClassName`	Class of mxArray as string
`mxSetClassName`	Structure array to MATLAB object array
`mxGetProperty`	Value of public property of MATLAB object
`mxSetProperty`	Set value of public property of MATLAB object

구조체

`mxCreateStructMatrix`	2차원 구조체형 배열
`mxCreateStructArray`	N차원 구조체형 배열
`mxIsStruct`	Determine whether mxArray is structure
`mxGetField`	Pointer to field value from structure array, given index and field name
`mxSetField`	Set field value in structure array, given index and field name
`mxGetNumberOfFields`	Number of fields in structure array
`mxGetFieldNameByNumber`	Pointer to field name from structure array, given field number
`mxGetFieldNumber`	Field number from structure array, given field name
`mxGetFieldByNumber`	Pointer to field value from structure array, given index and field number
`mxSetFieldByNumber`	Set field value in structure array, given index and field number
`mxAddField`	구조체형 배열에 필드 추가
`mxRemoveField`	Remove field from structure array

셀형

`mxCreateCellMatrix`	2-D cell array
`mxCreateCellArray`	N-D cell array
`mxIsCell`	Determine whether mxArray is cell array
`mxGetCell`	Pointer to element in cell array
`mxSetCell`	Set contents of cell array

mxArray 삭제 및 복제

`mxDestroyArray`	MXCREATE* 함수에 의해 할당된 동적 메모리 해제
`mxDuplicateArray`	배열의 깊은 복사본 생성

mxArray 변환하기