hdfan

Интерфейс мультифайловых аннотаций (AN) шлюза к HDF

Синтаксис

[out1,...,outN] = hdfan(funcstr,input1,...,inputN)

Описание

hdfan является шлюзом MATLAB ® к интерфейсу многофайловых аннотаций HDF (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)`	Создает аннотацию данных для объекта, идентифицированного указанным тегом и ссылочным номером. `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)`	Считывает аннотацию, соответствующую данному идентификатору аннотации;
`'readann'`	`[annot_string,status] = hdfan('readann',annot_id,max_str_length)`	Считывает аннотацию, соответствующую данному идентификатору аннотации. `annot_string` не будет длиннее, чем `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)`	Получение количества меток файла, описания файла, метки данных и аннотаций описания данных в файле, соответствующем `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 может неправильно записать все данные в файл.

См. также

Представлен до R2006a

Документация