hdfan
HDF 다중 파일 주석(AN) 인터페이스에 대한 게이트웨이
구문
[out1,...,outN] = hdfan(funcstr,input1,...,inputN)
설명
hdfan
는 HDF 다중 파일 주석(AN) 인터페이스에 대한 MATLAB® 게이트웨이입니다.
[out1,...,outN] = hdfan(funcstr,input1,...,inputN)
은 functstr
로 지정된 HDF 라이브러리의 AN 함수에 해당하는 하나 이상의 출력을 반환합니다.
HDF 라이브러리의 AN 함수와 funcstr
에 대한 유효한 값 사이에는 일대일의 대응 관계가 있습니다. 예를 들어, hdfan('endaccess',annot_id)
는 C 라이브러리 호출 ANendaccess(annot_id)
에 해당됩니다.
액세스 함수
액세스 함수는 인터페이스를 초기화하고 주석에 대한 액세스를 제공하거나 종료합니다.
funcstr 의 값 | 함수 구문 | 설명 |
---|---|---|
'start' | AN_id = hdfan('start',file_id) | Multifile Annotation(다중 파일 주석) 인터페이스를 초기화합니다. |
'select' | annot_id = hdfan('select',AN_id, index,annot_type) | 주어진 인덱스 값과 주석 유형으로 식별된 주석의 식별자를 선택하고 반환합니다. |
'end' | status = hdfan('end',AN_id) | 다중 파일 주석 인터페이스에 대한 액세스를 종료합니다. |
'create' | annot_id = hdfan('create',AN_id,tag,ref,annot_type) | 지정된 태그와 참조 번호로 식별된 객체의 데이터 주석을 생성합니다. |
'createf' | annot_id = hdfan('createf',AN_id,annot_type) | 파일 레이블 또는 파일 설명 주석을 생성합니다. |
'endaccess' | status = hdfan('endaccess',annot_id) | 주석에 대한 액세스를 종료합니다. |
읽기/쓰기 함수
읽기/쓰기 함수는 파일 또는 객체 주석을 읽고 씁니다.
funcstr 의 값 | 함수 구문 | 설명 |
---|---|---|
'writeann' | status = hdfan('writeann',annot_id,annot_string) | 주어진 주석 식별자에 해당하는 주석을 씁니다. |
'readann' | [annot_string,status] = hdfan('readann',annot_id) | 주어진 주석 식별자에 해당하는 주석을 읽습니다. |
[annot_string,status] = hdfan('readann',annot_id,max_str_length) | 주어진 주석 식별자에 해당하는 주석을 읽습니다. |
일반 조회 함수(General Inquiry Function)
일반 조회 함수는 파일의 주석에 대한 정보를 반환합니다.
funcstr 의 값 | 함수 구문 | 설명 |
---|---|---|
'numann' | num_annot = hdfan('numann',AN_id,annot_type,tag,ref) | 주어진 태그/참조(Tag/Ref) 쌍에 해당하는 지정된 형식의 주석의 수를 가져옵니다. |
'annlist' | [ann_list,status] = hdfan('annlist',AN_id,annot_type,tag,ref) | 주어진 태그/참조 쌍에 해당하는 파일 내의 해당 형식의 주석 목록을 가져옵니다. |
'annlen' | length = hdfan('annlen',annot_id) | 주어진 주석 식별자에 해당하는 주석의 길이를 가져옵니다. |
'fileinfo' | [nfl,nfd,ndl,ndd,status] = hdfan('fileinfo',AN_id) |
|
'get_tagref' | [tag,ref,status] = hdfan('get_tagref',AN_id,index,annot_type) | 지정된 주석 형식 및 인덱스에 대한 태그/참조 쌍을 가져옵니다. |
'id2tagref' | [tag,ref,status] = hdfan('id2tagref',annot_id) | 지정된 주석 식별자에 해당하는 태그/참조 쌍을 가져옵니다. |
'tagref2id' | annot_id = hdfan('tagref2id',AN_id,tag,ref) | 지정된 태그/참조 쌍에 해당하는 주석 식별자를 가져옵니다. |
'atype2tag' | tag = hdfan('atype2tag',annot_type) | 지정된 주석 형식에 해당하는 태그를 가져옵니다. |
'tag2atype' | annot_type = hdfan('tag2atype',tag) | 지정된 태그에 해당하는 주석 형식을 가져옵니다. |
입력/출력 인수
status
또는 식별자 출력값이 -1이면 작업이 실패했음을 나타냅니다.
일반적으로, 입력 인수 annot_type
은 다음 값 중 하나가 될 수 있습니다.
'file_label'
'file_desc'
'data_label'
'data_desc'
AN_id
는 Multifile Annotation(다중 파일 주석) 인터페이스 식별자를 의미합니다.
annot_id
는 개별 주석 식별자를 의미합니다.
식별자 액세스를 종료할 때는 반드시 hdfan('end',AN_id)
또는 hdfan('endaccess',annot_id)
를 사용하여 열려 있는 모든 식별자의 액세스를 종료해야 합니다. 그러지 않을 경우 HDF 라이브러리가 모든 데이터를 파일에 제대로 기록하지 못할 수 있습니다.
버전 내역
R2006a 이전에 개발됨