exponenta event banner

hdfvs

Функции шлюза к VS в интерфейсе HDF Vdata

Синтаксис

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

Описание

hdfvs является шлюзом MATLAB ® для функций VS в интерфейсе HDF Vdata.

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

Существует однозначное соответствие между функциями VS в библиотеке HDF и допустимыми значениями для funcstr. Например, hdfvs('detach',vdata_id) соответствует вызову библиотеки C VSdetach(vdata_id).

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

Функции доступа подключаются к vdatas или разрешают доступ к ним. Передача данных может происходить только после обращения к данным vdata. Эти процедуры также отключают или надлежащим образом прекращают доступ к vdatas после завершения передачи данных.

Значение funcstrСинтаксис функцииОписание
'attach'vdata_id = hdfvs('attach',file_id,vdata_ref,access)Устанавливает доступ к указанным данным vdata. access может быть 'r' или 'w'.
'detach'status = hdfvs('detach',vdata_id)Прекращает доступ к указанным данным vdata.

Функции чтения и записи

Функции чтения и записи считывают и записывают содержимое vdata.

Значение funcstrСинтаксис функцииОписание
'fdefine'status = hdfvs('fdefine',vdata_id,fieldname,data_type,order)Определяет новое поле vdata. data_type - вектор символов или строковый скаляр, содержащий тип номера HDF. Определить data_type как одно из следующих значений: 'uchar8', 'uchar', 'char8', 'char', 'double', 'uint8', 'uint16', 'uint32', 'float', 'int8', 'int16', или 'int32'.
'setclass'status = hdfvs('setclass',vdata_id,class)Назначает класс vdata.
'setfields'status = hdfvs('setfields',vdata_id,fields)Указывает поля vdata для записи.
'setinterlace'status = hdfvs('setinterlace',vdata_id,interlace)Устанавливает режим чередования для vdata. interlace может быть 'full' или 'no'.
'setname'status = hdfvs('setname',vdata_id,name)Присваивает имя данным vdata.
'write'count = hdfvs('write', vdata_id, data)Запись в vdata. данные должны быть nfieldsмассив ячеек -by-1. Каждая ячейка должна содержать order(i)около-n вектор данных, где order(i) - количество скалярных значений в каждом поле. Типы данных должны соответствовать типам полей, установленным с помощью hdfvs('setfields') или поля в уже существующих vdata.
'read'[data,count] = hdfvs('read',vdata_id,n)Считывает из vdata. Данные возвращаются в nfieldsмассив ячеек -by-1. Каждая ячейка содержит order(i)около-n вектор данных, где order - количество скалярных значений в каждом поле. Поля возвращаются в том же порядке, что и указано в hdfvs('setfields',...).
'seek'pos = hdfvs('seek',vdata_id,record)Поиск указанной записи в vdata.
'setattr'status = hdfvs('setattr',vdata_id,field_index,name,A)Задает атрибут поля vdata или vdata.
'setexternalfile'status = hdfvs('setexternalfile',vdata_id,filename,offset)Хранит информацию о vdata во внешнем файле.
'getattr'[value,status] = hdfvs('getattr',vdata_id,field_index,attr_index)Считывает значение атрибута, присоединенного к полю vdata или vdata. Набор field_index кому 'vdata' для извлечения атрибута, присоединенного к самому полю. Набор field_index в числовой индекс поля для извлечения атрибута, присоединенного к полю vdata.
'setattr'status = hdfvs('setattr',vdata_id,field_index,name,A)Задает атрибут поля vdata или vdata.field_index может быть индексным номером или 'vdata'.

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

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

Значение funcstrСинтаксис функцииОписание
'find'vdata_ref = hdfvs('find',file_id,vdata_name)Поиск заданного имени vdata в указанном HDF-файле.
'findclass'vdata_ref = hdfvs('findclass',file_id,vdata_class)Возвращает ссылочный номер первого класса vdata, соответствующего указанному классу vdata.
'getid'next_ref = hdfvs('getid',file_id,vdata_ref)Возвращает идентификатор следующего vdata в файле.
'lone'[refs,count] = hdfvs('lone',file_id,maxsize)Возвращает ссылочные номера vdatas, которые не связаны в vgroups.

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

Функции запроса Vdata предоставляют конкретную информацию о данном VDATA, включая имя VDATA, класс, количество полей, количество записей, пары тегов и ссылок, режим чередования и размер.

Значение funcstrСинтаксис функцииОписание
'fexist'status = hdfvs('fexist',vdata_id,fields)Проверка наличия полей в указанных vdata.
'inquire'[n,interlace,fields,nbytes,vdata_name,status] = ... hdfvs('inquire',vdata_id)Возвращает сведения об указанных vdata.
'elts'count = hdfvs('elts',vdata_id)Возвращает число записей в указанных vdata.
'getclass'[class_name,status] = hdfvs('getclass',vdata_id)Возвращает класс HDF указанных vdata.
'getfields'[field_names,count] = hdfvs('getfields',vdata_id)Возвращает все имена полей в указанных vdata.
'getinterlace'[interlace,status] = hdfvs('getinterlace',vdata_id)Извлекает режим чередования указанных vdata.
'getname'[vdata_name,status] = hdfvs('getname',vdata_id)Извлекает имя указанного vdata.
'getversion'version = hdfvs('getversion',vdata_id)Возвращает номер версии vdata.
'sizeof'nbytes = hdfvs('sizeof',vdata_id,fields)Возвращает размеры полей указанных vdata.
'Queryfields'[fields,status] = hdfvs('Queryfields',vdata_id)Возвращает имена полей указанных vdata.
'Queryname'[name,status] = hdfvs('Queryname',vdata_id)Возвращает имя указанного vdata.
'Queryref'ref = hdfvs('Queryref',vdata_id)Извлекает ссылочный номер указанного vdata.
'Querytag'tag = hdfvs('Querytag',vdata_id)Извлекает тег указанных vdata.
'Querycount'[count,status] = hdfvs('Querycount',vdata_id)Возвращает число записей в указанных vdata.
'Queryinterlace'[interlace,status] = hdfvs('Queryinterlace',vdata_id)Возвращает режим чередования указанных vdata.
'Queryvsize'vsize = hdfvs('Queryvsize',vdata_id)Извлекает локальный размер в байтах указанной записи vdata.
'findex'[field_index,status] = hdfvs('findex',vdata_id,fieldname)Запрашивает индекс поля vdata с именем поля.
'nattrs'count = hdfvs('nattrs',vdata_id)Возвращает количество атрибутов указанных vdata и содержащихся в них полей vdata.
'fnattrs'count = hdfvs('fnattrs',vdata_id,field_index)Запрашивает общее число атрибутов vdata.
'findattr'attr_index = hdfvs('findattr',vdata_id,field_index,attr_name)Извлекает индекс атрибута с именем атрибута.
'isattr'tf = hdfvs('isattr',vdata_id)Определяет, является ли данное vdata атрибутом.
'attrinfo'[name,data_type,count,nbytes,status] = hdfvs('attrinfo',... vdata_id,field_index,attr_index)Возвращает имя, тип данных, количество значений и размер значений указанных атрибутов указанного поля vdata или vdata.

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

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

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