exponenta event banner

H5L.get_val

Значение символьной ссылки

Синтаксис

linkval = H5L.get_val(link_loc_id,link_name,lapl_id)
linkval = H5L.get_val(link_loc_id,link_name,lapl_id,'TextEncoding',encoding)

Описание

linkval = H5L.get_val(link_loc_id,link_name,lapl_id) возвращает значение символьной ссылки.

link_loc_id является идентификатором файла или группы. link_name определяет символьную ссылку и определяется относительно link_loc_id. Символьные ссылки включают динамические и внешние ссылки и некоторые пользовательские ссылки.

В случае мягких звеньев linkval - массив ячеек, содержащий путь, на который указывает ссылка.

В случае внешних связей linkval - массив ячеек, состоящий из имени целевого файла и имени объекта.

Эта функция соответствует H5L.get_val и H5Lunpack_elink_val функции в API HDF5 1.8 C.

linkval = H5L.get_val(link_loc_id,link_name,lapl_id,'TextEncoding',encoding) дополнительно указывает текстовую кодировку, используемую для интерпретации значения ссылки. Определить encoding как 'system'(по умолчанию) или 'UTF-8'.

  • 'system' - Используйте системную кодировку по умолчанию для интерпретации значения канала.

  • 'UTF-8' - Использование UTF-8 кодирование для интерпретации значения линии связи.

Примеры

fid = H5F.open('example.h5');
gid = H5G.open(fid,'/g1/g1.2/g1.2.1');
linkval = H5L.get_val(gid,'slink','H5P_DEFAULT');
H5G.close(gid);
H5F.close(fid);