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 функционирует в HDF5 1.8 C API.

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);