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)-by- n вектор данных, где order(i) - количество скалярных значений в каждом поле. Типы данных должны совпадать с типами полей, заданными посредством hdfvs('setfields') или поля в уже существующих vdata.
'read'[data,count] = hdfvs('read',vdata_id,n)Читает из vdata. Данные возвращаются в nfieldsмассив ячеек -by-1. Каждая камера содержит order(i)-by- 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, которые не связаны с группами.

Функции запроса 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