mxSetComplexDoubles(C)

mxDOUBLE_CLASS 배열에 복소수 데이터 요소 설정

페이지 내 모두 확장

C 구문

#include "matrix.h"
int mxSetComplexDoubles(mxArray *pa, mxComplexDouble *dt);

설명

mxSetComplexDoubles를 사용하여 지정된 배열에 mxComplexDouble 데이터를 설정합니다.

모든 mxCreate* 함수는 데이터를 유지하기 위해 힙 공간을 할당합니다. 따라서, 보통 이 함수는 배열의 요소를 초기화하는 데 사용하지 않습니다. 그보다 기존 값을 새로운 값으로 교체하는 경우에 이 함수를 호출하십시오.

입력 인수

모두 확장

mxDOUBLE_CLASS 배열에 대한 포인터.

데이터 배열의 첫 번째 mxComplexDouble 요소에 대한 포인터. dt는 mxCalloc 또는 mxMalloc 함수에 의해 할당되어야 합니다.

출력 인수

모두 확장

함수 상태로, int로 반환됩니다. 성공하는 경우, 함수는 1을 반환합니다.

pa가 NULL이면, 함수는 0을 반환합니다.

mxArray가 공유되지 않은 mxDOUBLE_CLASS 배열이거나 데이터가 mxCalloc 함수로 할당되지 않은 경우 이 함수는 실패합니다. 함수가 실패한 경우, 다음을 반환합니다.

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

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

예제

matlabroot/extern/examples/refbook 폴더에 있는 arrayFillSetPr.c 예제를 참조하십시오. 이 예제는 기존 데이터를 mxArray에 복사합니다. 예제의 데이터는 mxDouble로 정의되었습니다. 이 예제를 복소수를 포함한 모든 C 숫자형에 대한 패턴으로 활용할 수 있습니다. 다음 값을 갖는 배열이 있다고 가정합니다.

2.0 + 3.0i
3.0 + 4.0i

이 예제에서 복소수 mxDouble 데이터를 수정하려면 다음을 수행하십시오.

  • 데이터 변수를 선언합니다.

    mxComplexDouble *dynamicData;
const mxComplexDouble data[] = {{2.0, 3.0}, {3.0, 4.0}};

  • mxCOMPLEX 인수와 함께 mxCreateNumericMatrix를 호출합니다.

  • mxSetDoubles를 mxSetComplexDoubles로 바꾸어 C 배열을 mxArray에 넣습니다.

API 버전

이 함수는 실수부/허수부 결합형 복소수 API에서 사용 가능합니다. 이 함수를 사용하여 myMexFile.c를 빌드하려면 다음을 입력하십시오.

mex -R2018a myMexFile.c

버전 내역

R2018a에 개발됨

참고 항목

|