mxCreateStructMatrix(Fortran)

2차원 구조체형 배열

Fortran 구문

#include "fintrf.h"
mwPointer mxCreateStructMatrix(m, n, nfields, fieldnames)
mwSize m, n
integer*4 nfields
character*(*) fieldnames(nfields)

설명

mxCreateStructMatrix를 호출하여, 채워지지 않은 2차원 구조체의 mxArray를 생성합니다. 이 구조체에 대한 자세한 내용은 mxCreateStructArray 항목을 참조하십시오.

mxArray 사용을 마치면 mxDestroyArray를 호출하십시오. mxDestroyArray는 mxArray 및 이와 연결된 요소를 할당 해제합니다.

입력 인수

m — 행 개수

mwSize

행 개수로, mwSize로 지정됩니다.

n — 열 개수

mwSize

열 개수로, mwSize로 지정됩니다.

nfields — 필드 수

integer*4

각 요소의 필드 수로, integer*4로 지정됩니다.

fieldnames — 필드 이름

character*(*)

하나 이상의 필드 이름으로, character*(*)로 지정됩니다.

필드 이름은 유효한 MATLAB^® 식별자여야 합니다. 즉, 비어 있을 수 없습니다. 필드 이름은 대/소문자를 구분합니다. 필드 이름의 최대 길이를 확인하려면 namelengthmax 함수를 사용하십시오.

pm — mxArray에 대한 포인터

mwPointer | 0

mxArray에 대한 포인터로, mwPointer로 지정됩니다(성공하는 경우).

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

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

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

버전 내역

R2006a 이전에 개발됨

참고 항목

mxCreateStructArray | mxDestroyArray | namelengthmax