hdfv
HDF Vgroup(V) 인터페이스의 게이트웨이
구문
[out1,...,outN] = hdfv(funcstr,input1,...,inputN)
설명
hdfv
는 HDF Vgroup(V) 인터페이스의 MATLAB® 게이트웨이입니다.
[out1,...,outN] = hdfv(funcstr,input1,...,inputN)
은 functstr
로 지정된 HDF 라이브러리의 V 함수에 해당하는 하나 이상의 출력을 반환합니다.
HDF 라이브러리의 V 함수와 funcstr
에 대한 유효한 값 사이에는 일대일의 대응 관계가 있습니다. 예를 들어, hdfv('nattrs',vgroup_id)
는 C 라이브러리 호출 Vnattrs(vgroup_id)
에 해당됩니다.
액세스 함수
액세스 함수는 파일을 열고, Vgroup 인터페이스를 초기화하고, 개별 그룹에 액세스합니다. 또한 Vgroup과 Vgroup 인터페이스를 종료하고 HDF 파일을 닫습니다.
funcstr 의 값 | 함수 구문 | 설명 |
---|---|---|
'start' | status = hdfv('start',file_id) | V 인터페이스를 초기화합니다. |
'attach' | vgroup_id = hdfv('attach',file_id,vgroup_ref,access) | Vgroup의 액세스를 설정합니다. access 는 'r' 또는 'w' 가 될 수 있습니다. |
'detach' | status = hdfv('detach',vgroup_id) | vgroup의 액세스를 종료합니다. |
'end' | status = hdfv('end',file_id) | V 인터페이스의 액세스를 종료합니다. |
생성 함수
생성 함수는 데이터 객체를 구성하고, 해당 레이블을 지정하고, vgroup에 추가합니다.
funcstr 의 값 | 함수 구문 | 설명 |
---|---|---|
'setclass' | status = hdfv('setclass',vgroup_id,class) | vgroup에 클래스를 할당합니다. |
'setname' | status = hdfv('setname',vgroup_id,name) | vgroup에 이름을 할당합니다. |
'insert' | ref = hdfv('insert',vgroup_id, id) | 기존 그룹에 vgroup 또는 vdata를 추가합니다. id 는 vdata ID 또는 vgroup ID가 될 수 있습니다. |
'addtagref' | status = hdfv('addtagref',vgroup_id,tag,ref) | HDF 데이터 객체를 기존 그룹에 추가합니다. |
'setattr' | status = hdfv('setattr',vgroup_id,name,A) | vgroup의 특성을 설정합니다. |
파일 조회 함수
파일 조회 함수는 파일에 vgroup이 어떻게 저장되는지에 대한 정보를 반환합니다. 이들 함수는 파일에서 vgroup을 찾아내는 데 유용합니다.
funcstr 의 값 | 함수 구문 | 설명 |
---|---|---|
'lone' | [refs,count] = hdfv('lone',file_id,maxsize) | 다른 vgroup에 포함되지 않은 vgroup의 참조 번호를 반환합니다. |
'getid' | next_ref = hdfv('getid',file_id,vgroup_ref) | HDF 파일의 다음 vgroup에 대한 참조 번호를 반환합니다. |
'find' | vgroup_ref = hdfv('find',file_id,vgroup_name) | 성공적일 경우 지정된 이름을 가진 vgroup의 참조 번호를 반환하고, 그렇지 않을 경우 0을 반환합니다. |
'findclass' | vgroup_ref = hdfv('findclass',file_id,class) | 지정된 클래스를 가진 vgroup의 참조 번호를 반환합니다. |
Vgroup 조회 함수
Vgroup 조회 함수는 특정 vgroup에 대한 특정 정보를 제공합니다. 이 정보에는 클래스, 이름, 멤버 수, 멤버에 대한 추가 정보가 포함됩니다.
funcstr 의 값 | 함수 구문 | 설명 |
---|---|---|
'getclass' | [class_name,status] = hdfv('getclass',vgroup_id) | 지정된 그룹 클래스의 이름을 반환합니다. |
'getname' | [vgroup_name,status] = hdfv('getname',vgroup_id) | 지정된 그룹의 이름을 반환합니다. |
'inquire' | [num_entries,name,status] = hdfv('inquire',vgroup_id) | 항목 수와 vgroup의 이름을 반환합니다. |
'isvg' | status = hdfv('isvg',vgroup_id,ref) | ref로 지정된 객체가 vgroup_id 로 지정된 vgroup의 자식 vgroup을 참조하는지 확인합니다. |
'isvs' | status = hdfv('isvs',vgroup_id,vdata_ref) | vdata_ref 로 지정된 객체가 vgroup_id 로 지정된 vgroup의 자식 vdata를 참조하는지 확인합니다. |
'gettagref' | [tag,ref,status] = hdfv('gettagref',vgroup_id,index) | 지정된 vgroup의 데이터 객체에 대한 태그/참조 번호 쌍을 가져옵니다. |
'ntagrefs' | count = hdfv('ntagrefs',vgroup_id) | 지정된 vgroup에 포함된 태그/참조 번호 쌍의 수를 반환합니다. |
'gettagrefs' | [tag,refs,count] = hdfv('gettagrefs',vgroup_id,maxsize) | vgroup 내 모든 데이터 객체의 태그/참조 쌍을 가져옵니다. |
'inqtagref' | tf = hdfv('inqtagref',vgroup_id,tag,ref) | 객체가 vgroup에 속하는지 확인합니다. |
'getversion' | version = hdfv('getversion',vgroup_id) | 주어진 vgroup의 vgroup 버전을 확인합니다. |
'nattrs' | count = hdfv('nattrs',vgroup_id) | vgroup 특성의 총수를 쿼리합니다. |
'attrinfo' | [name,data_type,count,nbytes,status] = hdfv('attrinfo',vgroup_id,... attr_index) | 주어진 vgroup 특성에 대한 정보를 쿼리합니다. |
'getattr' | [values,status] = hdfv('getattr',vgroup_id,attr_index) | 주어진 특성의 값을 쿼리합니다. |
'Queryref' | ref = hdfv('Queryref',vgroup_id) | 지정된 vgroup의 참조 번호를 반환합니다. |
'Querytag' | tag = hdfv('Querytag',vgroup_id) | 지정된 vgroup의 태그를 반환합니다. |
'flocate' | vdata_ref = hdfv('flocate',vgroup_id,field) | 지정된 vgroup에서 지정된 필드 이름을 포함하는 vdata의 참조 번호를 반환합니다. |
'nrefs' | count = hdfv('nrefs',vgroup_id,tag) | 지정된 vgroup에서 지정된 태그를 가진 데이터 객체의 수를 반환합니다. |
출력 인수
status
또는 식별자 출력값이 -1이면 작업이 실패했음을 나타냅니다.
버전 내역
R2006a 이전에 개발됨