Main Content

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)

지정된 태그와 참조 번호로 식별된 객체의 데이터 주석을 생성합니다. annot_type은 'data_label'이거나 'data_desc'일 수 있습니다.

'createf'annot_id = hdfan('createf',AN_id,annot_type)

파일 레이블 또는 파일 설명 주석을 생성합니다. annot_type은 'file_label' 또는 'file_desc'가 될 수 있습니다.

'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)

주어진 주석 식별자에 해당하는 주석을 읽습니다. annot_string은 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)

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 이전에 개발됨

참고 항목

| | | | | | | | | | |