mxSetComplexInt16s (C)

R2026b

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

페이지 내 모두 확장

C 구문

#include "matrix.h"
int mxSetComplexInt16s(mxArray *pa, mxComplexInt16 *dt);

설명

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

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

입력 인수

모두 확장

mxINT16_CLASS 배열에 대한 포인터.

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

출력 인수

모두 확장

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

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

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

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

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

예제

matlabroot/extern/examples/refbook 폴더에 있는 arrayFillSetComplexPr.c 예제를 참조하십시오. 이 예제는 기존 복소수 숫자형 데이터를 mxArray에 복사합니다. 예제의 데이터는 mxComplexDouble로 정의되었습니다. 이 예제를 모든 복소수 C 숫자형에 대한 패턴으로 활용할 수 있습니다. 이 예제를 복소수 int16 데이터에 맞게 수정하려면 다음을 수행하십시오.

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

  • 숫자형 mxINT16_CLASS와 함께 mxCreateNumericMatrix를 호출합니다.

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

API 버전

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

mex -R2018a myMexFile.c

버전 내역

R2018a에 개발됨

참고 항목

|