hdfan

Шлюз к многофайловому интерфейсу (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)`	Создает аннотацию данных для объекта, идентифицированного заданным номером тега и ссылочным номером. `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)`	Получает тип аннотации, соответствующий заданному тегу.

Аргументы ввода/вывода

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

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