Main Content

이 페이지의 최신 내용은 아직 번역되지 않았습니다. 최신 내용은 영문으로 볼 수 있습니다.

h5writeatt

HDF5 특성 쓰기

구문

h5writeatt(filename,loc,attr,val)
h5writeatt(filename,loc,attr,val,'TextEncoding',encoding)

설명

h5writeatt(filename,loc,attr,val)은 HDF5 파일 내 지정된 위치에 이름이 attr인 특성과 값 val을 씁니다.

h5writeatt(filename,loc,attr,val,'TextEncoding',encoding)은 지정된 인코딩을 사용하여 HDF5 파일 내 지정된 위치에 attr을 씁니다. 'UTF-8''TextEncoding'의 디폴트 설정이며, 'system'은 시스템 인코딩을 사용하여 문자를 표현합니다. 일반적으로 'system'을 인코딩으로 지정하는 것은 필요하지 않습니다.

예제

모두 축소

examplefile.h5의 루트 그룹에 값이 현재 시간인 특성을 씁니다.

date = datestr(now);
h5writeatt('examplefile.h5','/','creation_date', date);

HDF5 파일의 루트 그룹에서 특성을 읽어옵니다.

val1 = h5readatt('examplefile.h5','/','creation_date')
val1 = 
'31-Jan-2020 22:42:10'

double형 배열을 만들어서 데이터셋 /g4/world.에 씁니다.

attData = [0 1 2 3];
h5writeatt('examplefile.h5','/g4/world','val2',attData);

데이터셋 메타데이터를 표시합니다. 특성 val2는 데이터셋에 속하는 특성 중 하나로 표시됩니다.

h5disp('examplefile.h5','/g4/world');
HDF5 examplefile.h5 
Dataset 'world' 
    Size:  36x19
    MaxSize:  36x19
    Datatype:   H5T_IEEE_F64LE (double)
    ChunkSize:  []
    Filters:  none
    FillValue:  0.000000
    Attributes:
        'val2':  0.000000 1.000000 2.000000 3.000000 

입력 인수

모두 축소

파일 이름으로, 기존 HDF5 파일의 이름을 포함하는 문자형 벡터 또는 string형 스칼라로 지정됩니다.

파일에서의 위치로, 특성을 연결할 기존 그룹 또는 데이터셋의 전체 경로 이름을 포함하는 문자형 벡터 또는 string형 스칼라로 지정됩니다.

특성의 이름으로, 그룹 또는 데이터셋에 속하는 특성의 이름을 포함하는 문자형 벡터 또는 string형 스칼라로 지정됩니다. 속성이 존재하지 않는 경우 h5writeatt는 지정된 이름을 가진 특성을 생성합니다.

지정된 특성이 이미 존재하지만 val과 일치하는 데이터형 또는 데이터스페이스가 없을 경우 h5writeatt는 이 특성을 삭제한 후 다시 생성합니다. string형 특성은 단일 0차원 데이터 점인 스칼라 데이터스페이스로 생성됩니다.

쓸 특성 값으로, 문자형 벡터, string형 스칼라 또는 숫자형 값으로 지정됩니다.

텍스트 인코딩으로, 'TextEncoding'과 함께 다음 값 중 하나가 쉼표로 구분되어 지정됩니다.

  • 'UTF-8' — UTF-8 인코딩을 사용하여 문자를 표현합니다.

  • 'system' — 시스템 인코딩을 사용하여 문자를 바이트로 표현합니다(권장되지 않음).

호환성 관련 고려 사항

모두 확장

R2020a에서 동작이 변경됨

R2011a에 개발됨