Интерфейс шлюза к мультифайлу (AN)
[out1,...,outN] = hdfan(funcstr,input1,...,inputN)
hdfan является MATLAB® шлюз к интерфейсу мультифайл аннотацией (AN).
[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) | Получение типа аннотации, соответствующего указанному тегу. |
A 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
