Byte Length

카테고리: 유틸리티 · 노드 타입 ID: utility-byte-length

입력을 바이트로 바꾸어(string은 UTF-8, int는 최소 길이, bool은 1바이트) 바이트 수를 돌려준다

개요

다형성 입력 값을 바이트 표현(Bytes는 그대로, String은 UTF-8 인코딩, Int는 최소 길이 부호 없는 바이트, Bool은 1바이트)으로 변환했을 때의 바이트 개수(Byte Count)를 정수(Int)로 반환한다.

버퍼, 키, 암호문, 또는 UTF-8 문자열의 바이트 길이를 측정해 Int to Bytes나 Value Comparator로 전달할 때 사용한다.

Byte Length는 설정 가능한 정적 파라미터가 없다.

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

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

포트 이름	포트 ID	데이터 타입	필수 여부	노출 조건	설명
`Value`	`in`	`Any`	필수	항상 노출

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

포트 이름	포트 ID	데이터 타입	노출 조건	설명
`Length`	`length`	`Int`	항상 노출	계산된 바이트 수(0 이상의 `Int`)이다.

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

오류 코드	기본 엔진 메시지	발생 조건
`BYTES_INVALID_ARGUMENT`	인자 값이 올바르지 않는다	입력 정수가 음수이거나 지원하지 않는 타입일 때 발생한다.
`BYTES_INT_OVERFLOW`	정수가 지정한 길이·부호로 표현되지 않는다	정수 값이 지정한 고정 또는 포트 바이트 길이 안에 표현될 수 없을 때 발생한다.

암호문 바이트 배열의 길이를 정수로 출력한다.