Value Comparator

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

같은 타입(bytes, string, int, bool)의 두 값을 ==, !=, >, >=, <, <=로 비교한다

개요

같은 데이터 타입(Bytes, String, Int, Bool)의 두 입력 A와 B를 선택한 관계 연산자(==, !=, >, >=, <, <=)로 비교하여 불리언 결과(Result)를 내보낸다.

Bytes는 사전식(Lexicographical) 바이트 순서로 비교하며, 판정 오류 프로필(Judgement Error Profile)을 지원하므로 불일치 시 false를 데이터로 흘려보내거나 즉시 워크플로우 오류로 전환할 수 있다.

파라미터 (ID)	타입 및 기본값	노출 조건	설명 및 옵션
비교 연산자 `operator`	`select` 기본값: `==`	항상 노출	두 피연산자 `A`와 `B` 사이에 적용할 비교 연산자이다. `==`: 같음(`A == B`). `!=`: 다름(`A != B`). `>`: 보다 큼(`A > B`). `>=`: 크거나 같음(`A >= B`). `<`: 보다 작음(`A < B`). `<=`: 작거나 같음(`A <= B`).
오류로 처리 `errorOnValue`	`select` 기본값: `""` (비움)	항상 노출	판정 결과를 오류로 재해석할 조건이다. 예를 들어 `false`로 설정하면 비교 결과가 `false`일 때 노드가 오류 상태로 전환된다. `(비움)`: 안 함(기본값: 판정 결과를 일반 불리언 데이터로 출력). `true`: 결과가 `true`일 때 오류 발생. `false`: 결과가 `false`일 때 오류 발생.
오류 코드 `errorCode`	`text` 기본값: `""` (비움) 변수 참조 지원 (`$var`: `string`)	`errorOnValue`가 `true` 또는 `false` 일 때	오류로 처리 조건이 발동했을 때 사용할 사용자 정의 오류 코드이다.
오류 메시지 `errorMessage`	`text` 기본값: `""` (비움) 변수 참조 지원 (`$var`: `string`)	`errorOnValue`가 `true` 또는 `false` 일 때	오류로 처리 조건이 발동했을 때 사용할 사용자 정의 오류 메시지이다.

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

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

포트 이름	포트 ID	데이터 타입	필수 여부	노출 조건	설명
`Value A`	`a`	`Any`	필수	항상 노출	첫 번째 비교 피연산자(`Any`: `Bytes`, `String`, `Int`, `Bool`)이다.
`Value B`	`b`	`Any`	필수	항상 노출	두 번째 비교 피연산자(`Any`: 반드시 `A`와 동일한 런타임 타입이어야 함)이다.

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

포트 이름	포트 ID	데이터 타입	노출 조건	설명
`Result`	`result`	`Bool`	항상 노출	비교가 성립하면 true

이 노드는 불리언 출력 포트 result에 대해 판정 오류 프로필(Judgement Error Profile)을 사용한다:

기본 동작 (오류로 처리 = 안 함): 검증이나 비교가 일치하지 않아도 런타임 오류를 발생시키지 않으며, 정상 완료 상태로 result 포트에 false(또는 true)를 내보내어 하위 노드나 스크립트가 불리언 결과를 활용할 수 있게 한다.
오류로 재해석 (오류로 처리 = false 또는 true): result 포트의 불리언 판정 값이 설정한 errorOnValue와 일치할 때 노드를 ERROR 상태로 전환하고 지정한 오류 코드와 오류 메시지를 발생시키며 하위 실행을 중단한다.

오류 코드	발생 조건
`BYTES_INVALID_ARGUMENT`	연결된 두 입력 `A`와 `B`의 데이터 타입이 서로 다르거나 비교할 수 없는 타입(예: `Set`)일 때 발생한다.

두 바이트 배열이 완전히 같은지 확인하고 다르면 오류를 발생시킨다.