Шлюз к многофайловому интерфейсу (AN) аннотации HDF
[out1,...,outN] = hdfan(funcstr,input1,...,inputN)
hdfan является шлюзом MATLAB® к многофайловому интерфейсу (AN) аннотации HDF.
[out1,...,outN] = hdfan(funcstr,input1,...,inputN) возвращает один или несколько выходных параметров, соответствующих функции AN в библиотеке HDF, заданной functstr.
Существует взаимно-однозначное соответствие между функциями AN в библиотеке HDF и допустимых значениях для funcstr. Например, hdfan('endaccess',annot_id) соответствует вызову библиотеки C ANendaccess(annot_id).
Функции доступа инициализируют интерфейс и обеспечивают и отключают доступ к аннотациям.
Значение funcstr | Синтаксис функций | Описание |
|---|---|---|
'start' | AN_id = hdfan('start',file_id) | Инициализирует многофайловый интерфейс аннотации. |
'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) | Читает аннотацию, соответствующую данному идентификатору аннотации. |
Функции справки по общим вопросам возвращают информацию об аннотациях в файле.
Значение funcstr | Синтаксис функций | Описание |
|---|---|---|
'numann' | num_annot = hdfan('numann',AN_id,annot_type,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 относится к многофайловому идентификатору интерфейса аннотации.
annot_id относится к отдельному идентификатору аннотации.
Необходимо отключить доступ ко всем открытым идентификаторам с помощью или hdfan('end',AN_id) или hdfan('endaccess',annot_id). В противном случае библиотека HDF не может правильно записать все данные в файл.
hdfdf24 | hdfdfr8 | hdfh | hdfhd | hdfhe | hdfhx | hdfml | hdfv | hdfvf | hdfvh | hdfvs | matlab.io.hdf4.sd
