Hex to Bytes
16진수 문자열을 바이트 배열로 디코딩한다
개요
16진수 문자열을 원시 이진 바이트 배열(Uint8Array)로 디코딩한다.
선행 0x/0X 접두사와 공백 문자(공백, 탭, 줄바꿈)를 자동으로 무시하므로 RFC나 NIST 문서에서 복사한 여러 줄의 16진수 블록을 그대로 붙여넣어 디코딩할 수 있다.
사용 시점
- 외부 텍스트나 문서에서 가져온 16진수 문자열을 암호화 노드의
Bytes입력으로 변환할 때 사용한다.
파라미터 설정
이 노드는 속성창에서 설정할 수 있는 별도의 정적 파라미터가 없으며, 알고리즘 규격과 연결된 포트 값에 의해서만 동작이 결정된다.
포트 입출력 명세
포트 연결 규칙, 데이터 타입별 색상, 가변 포트 생성 방식은 포트 및 연결 문서를 참고한다.
입력 포트
포트 성격: 고정 입력 포트 (총 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진수 텍스트 문자열을 원시 바이트로 변환한다.
deadbeef를 내보내는 문자열 소스를 Hex to Bytes의Hex String에 연결하면 4바이트Uint8Array가 출력된다.