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Синтаксис функцийОписание
запускAN_id = hdfan('start',file_id)

Инициализирует многофайловый интерфейс аннотации.

'select'annot_id = hdfan('select',AN_id, index,annot_type)

Выбирает и возвращает идентификатор для аннотации, идентифицированной данным индексным значением и типом аннотации.

конец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)

Читает аннотацию, соответствующую данному идентификатору аннотации;

[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

Была ли эта тема полезной?