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