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'.

  • система Используйте кодирование системного значения по умолчанию, чтобы интерпретировать значение ссылки.

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