hdfv

Шлюз к интерфейсу HDF Vgroup (V)

Синтаксис

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

Описание

hdfv является шлюзом MATLAB ® для интерфейса HDF Vgroup (V).

[out1,...,outN] = hdfv(funcstr,input1,...,inputN) возвращает один или несколько выходов, соответствующих функции V в библиотеке HDF, указанной functstr.

Существует однозначное соответствие между V-функциями в библиотеке HDF и допустимыми значениями для funcstr. Например, hdfv('nattrs',vgroup_id) соответствует вызову библиотеки C Vnattrs(vgroup_id).

Функции доступа

Функции доступа открывают файлы, инициализируют интерфейс Vgroup и осуществляют доступ к отдельным группам. Они также прекращают доступ к vgroups и интерфейсу Vgroup и закрывают HDF-файлы.

Значение `funcstr`	Синтаксис функции	Описание
`'start'`	`status = hdfv('start',file_id)`	Инициализирует V-интерфейс.
`'attach'`	`vgroup_id = hdfv('attach',file_id,vgroup_ref,access)`	Устанавливает доступ к vgroup. `access` может быть `'r'` или `'w'`.
`'detach'`	`status = hdfv('detach',vgroup_id)`	Прекращает доступ к vgroup.
`'end'`	`status = hdfv('end',file_id)`	Прекращает доступ к V-интерфейсу.

Создание функций

Создание функций организации, метки и добавления объектов данных в vgroups.

Значение `funcstr`	Синтаксис функции	Описание
`'setclass'`	`status = hdfv('setclass',vgroup_id,class)`	Назначает класс vgroup.
`'setname'`	`status = hdfv('setname',vgroup_id,name)`	Назначает имя vgroup.
`'insert'`	`ref = hdfv('insert',vgroup_id, id)`	Добавление vgroup или vdata в существующую группу. `id` может быть идентификатором vdata или идентификатором vgroup.
`'addtagref'`	`status = hdfv('addtagref',vgroup_id,tag,ref)`	Добавляет любой объект данных HDF к существующей vgroup.
`'setattr'`	`status = hdfv('setattr',vgroup_id,name,A)`	Задает атрибут vgroup.

Функции запроса файлов

Функции запроса файлов возвращают информацию о том, как vgroups хранятся в файле. Они полезны для поиска vgroups в файле.

Значение `funcstr`	Синтаксис функции	Описание
`'lone'`	`[refs,count] = hdfv('lone',file_id,maxsize)`	Возвращает ссылочные номера vgroups, не включенных в другие vgroups.
`'getid'`	`next_ref = hdfv('getid',file_id,vgroup_ref)`	Возвращает ссылочный номер для следующей vgroup в HDF-файле.
`'find'`	`vgroup_ref = hdfv('find',file_id,vgroup_name)`	Возвращает ссылочный номер vgroup с указанным именем, если он успешен и равен нулю.
`'findclass'`	`vgroup_ref = hdfv('findclass',file_id,class)`	Возвращает ссылочный номер vgroup с указанным классом.

Функции запроса Vgroup

Функции запроса Vgroup предоставляют конкретную информацию о конкретной vgroup. Эта информация включает класс, имя, число участников и дополнительные сведения об участниках.

Значение `funcstr`	Синтаксис функции	Описание
`'getclass'`	`[class_name,status] = hdfv('getclass',vgroup_id)`	Возвращает имя класса указанной группы.
`'getname'`	`[vgroup_name,status] = hdfv('getname',vgroup_id)`	Возвращает имя указанной группы.
`'inquire'`	`[num_entries,name,status] = hdfv('inquire',vgroup_id)`	Возвращает количество записей и имя vgroup.
`'isvg'`	`status = hdfv('isvg',vgroup_id,ref)`	Проверяет, ссылается ли объект, указанный в ref, на дочернюю vgroup группы vgroup, указанной в `vgroup_id`.
`'isvs'`	`status = hdfv('isvs',vgroup_id,vdata_ref)`	Проверяет, указан ли объект `vdata_ref` ссылается на дочерние vdata vgroup, указанные `vgroup_id`.
`'gettagref'`	`[tag,ref,status] = hdfv('gettagref',vgroup_id,index)`	Извлекает пару тег/ссылочный номер для объекта данных в указанной vgroup.
`'ntagrefs'`	`count = hdfv('ntagrefs',vgroup_id)`	Возвращает число пар тег/ссылочное число, содержащихся в указанной vgroup.
`'gettagrefs'`	`[tag,refs,count] = hdfv('gettagrefs',vgroup_id,maxsize)`	Извлекает пары тегов/ссылок всех объектов данных в vgroup.
`'inqtagref'`	`tf = hdfv('inqtagref',vgroup_id,tag,ref)`	Проверяет, принадлежит ли объект vgroup.
`'getversion'`	`version = hdfv('getversion',vgroup_id)`	Запрашивает версию vgroup данной vgroup.
`'nattrs'`	`count = hdfv('nattrs',vgroup_id)`	Запрашивает общее число атрибутов vgroup.
`'attrinfo'`	`[name,data_type,count,nbytes,status] = hdfv('attrinfo',vgroup_id,... attr_index)`	Запрашивает информацию о данном атрибуте vgroup.
`'getattr'`	`[values,status] = hdfv('getattr',vgroup_id,attr_index)`	Запрашивает значения данного атрибута.
`'Queryref'`	`ref = hdfv('Queryref',vgroup_id)`	Возвращает ссылочный номер указанной vgroup.
`'Querytag'`	`tag = hdfv('Querytag',vgroup_id)`	Возвращает тег указанной vgroup.
`'flocate'`	`vdata_ref = hdfv('flocate',vgroup_id,field)`	Возвращает ссылочный номер vdata, содержащий указанное имя поля в указанной vgroup.
`'nrefs'`	`count = hdfv('nrefs',vgroup_id,tag)`	Возвращает количество объектов данных с указанным тегом в указанной vgroup.

Выходные аргументы

A status или вывод идентификатора -1 указывает на сбой операции.

См. также

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

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