H5I.get_name

Имя объекта

Синтаксис

name = H5I.get_name(obj_id)
name = H5I.get_name(obj_id,'TextEncoding',encoding)

Описание

name = H5I.get_name(obj_id) возвращает имя объекта, заданного obj_id. Если никакое имя не присоединено к объекту, пустой символьный вектор возвращен.

name = H5I.get_name(obj_id,'TextEncoding',encoding) дополнительно задает текстовое кодирование, чтобы использовать, чтобы интерпретировать имя объекта. Задайте encoding как 'system' (значение по умолчанию) или 'UTF-8'.

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

  • 'UTF-8' — Используйте кодирование UTF-8, чтобы интерпретировать имя объекта.

Примеры

Отобразите имена всех объектов в группе /g3 в файле в качестве примера алфавитным порядком.

idx_type = 'H5_INDEX_NAME';
order = 'H5_ITER_INC';
fid = H5F.open('example.h5');
gid = H5G.open(fid,'/g3');
info = H5G.get_info(gid);
for j = 1:info.nlinks
    obj_id = H5O.open_by_idx(fid,'g3',idx_type,order,j-1,'H5P_DEFAULT');
    name = H5I.get_name(obj_id);
    fprintf('Object %d: ''%s''.\n',j-1,name);
    H5O.close(obj_id);
end
H5G.close(gid);
H5F.close(fid);