hdfv

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

Синтаксис

[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 и получения доступа к отдельным группам. Они также прекращают доступ к группам и интерфейсу Vgroup и закрывают файлы HDF.

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

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

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

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

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

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

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

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

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

A status или идентификатор выхода -1 указывает, что операция не выполнена.

См. также

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

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