NodeCrypto 도움말

Hex to Bytes

카테고리: 데이터 변환 & 인코딩 · 노드 타입 ID: converter-hex-to-bytes

16진수 문자열을 바이트 배열로 디코딩한다

개요

16진수 문자열을 원시 이진 바이트 배열(Uint8Array)로 디코딩한다.

선행 0x/0X 접두사와 공백 문자(공백, 탭, 줄바꿈)를 자동으로 무시하므로 RFC나 NIST 문서에서 복사한 여러 줄의 16진수 블록을 그대로 붙여넣어 디코딩할 수 있다.

사용 시점

파라미터 설정

이 노드는 속성창에서 설정할 수 있는 별도의 정적 파라미터가 없으며, 알고리즘 규격과 연결된 포트 값에 의해서만 동작이 결정된다.

포트 입출력 명세

포트 연결 규칙, 데이터 타입별 색상, 가변 포트 생성 방식은 포트 및 연결 문서를 참고한다.

입력 포트

포트 성격: 고정 입력 포트 (총 1개).

포트 이름포트 ID데이터 타입필수 여부노출 조건설명
Hex In string String 필수 항상 노출 디코딩할 16진수 문자열

출력 포트

포트 성격: 고정 출력 포트 (총 1개).

포트 이름포트 ID데이터 타입노출 조건설명
Bytes Out bytes Bytes 항상 노출 디코딩된 원시 바이트 배열(Uint8Array)이다.

오류 케이스

실행 중 아래 조건이 발생하면 이 노드는 ERROR 상태가 되며, 출력 포트에 연결된 하위 노드는 실행되지 않는다.

오류 코드기본 엔진 메시지발생 조건
INVALID_HEX_LENGTH Hex 문자열의 길이가 짝수가 아니다 0x 접두사와 공백을 제거한 뒤 남은 16진수 문자 개수가 홀수일 때 발생한다.
INVALID_HEX_CHAR Hex 문자열에 올바르지 않은 문자가 포함되어 있다 공백을 제외한 문자열에 0-9, a-f, A-F 이외의 문자가 포함되어 있을 때 발생한다.

활용 예시

16진수 문자열을 바이트 배열로 디코딩하기

16진수 텍스트 문자열을 원시 바이트로 변환한다.

  1. deadbeef를 내보내는 문자열 소스를 Hex to Bytes의 Hex String에 연결하면 4바이트 Uint8Array가 출력된다.