메인 콘텐츠로 건너뛰기

assumeNotNull

도입 버전: v1.1.0 널 허용 타입 값에 대응하는 non-널 허용 값을 반환합니다. 원래 값이 NULL이면 임의의 결과가 반환될 수 있습니다. 관련 항목: 함수 ifNullcoalesce. 구문
인수
  • x — 임의의 널 허용 타입의 원래 값입니다. Nullable(T)
반환 값 원래 값이 NULL이 아니면 널이 아닌 값을 반환하고, 입력 값이 NULL이면 임의의 값을 반환합니다. Any 예시 사용 예시
Query
Response

coalesce

도입 버전: v1.1.0 가장 왼쪽의 NULL이 아닌 인수를 반환합니다. 구문
인수
  • x[, y, ...] — 복합 타입이 아닌 매개변수를 개수 제한 없이 받을 수 있습니다. 모든 매개변수는 서로 호환되는 데이터 타입이어야 합니다. Any
반환 값 첫 번째 비-NULL 인수를 반환합니다. 모든 인수가 NULL이면 NULL을 반환합니다. Any 또는 NULL 예시 사용 예시
Query
Response

firstNonDefault

도입 버전: v25.9.0 여러 인수 중 기본값이 아닌 첫 번째 값을 반환합니다 구문
인수
  • arg1 — 확인할 첫 번째 인수 - arg2 — 확인할 두 번째 인수 - ... — 추가로 확인할 인수
반환 값 결과 유형은 모든 인수의 supertype입니다 예시 정수
Query
Response
문자열
Query
Response
NULL 값
Query
Response
널 허용 0값
Query
Response

ifNull

지원 시작 버전: v1.1.0 첫 번째 인수가 NULL이면 대체 값을 반환합니다. 구문
인수
  • xNULL 여부를 확인할 값입니다. Any
  • altxNULL인 경우 함수가 반환할 값입니다. Any
반환 값 xNULL이 아니면 x의 값을, 그렇지 않으면 alt를 반환합니다. Any 예시 사용 예시
Query
Response

isNotNull

도입 버전: v1.1.0 인수가 NULL이 아닌지 확인합니다. 참고: 연산자 IS NOT NULL. 구문
인수
  • x — 복합형이 아닌 데이터 타입의 값입니다. Any
반환 값 xNULL이 아니면 1을 반환하고, 그렇지 않으면 0을 반환합니다. UInt8 예시 사용 예시
Query
Response

isNull

도입 버전: v1.1.0 인수가 NULL인지 확인합니다. 참고: 연산자 IS NULL. 구문
인수
  • x — 복합형이 아닌 데이터 타입의 값입니다. Any
반환 값 xNULL이면 1을, 그렇지 않으면 0을 반환합니다. UInt8 예시 사용 예시
Query
Response

isNullable

도입 버전: v22.7.0 인수의 데이터 타입이 널 허용(즉, NULL 값을 허용하는 데이터 타입)인지 확인합니다. 구문
인수
  • x — 모든 데이터 타입의 값입니다. Any
반환 값 x널 허용 데이터 타입이면 1을, 그렇지 않으면 0을 반환합니다. UInt8 예시 사용 예시
Query
Response

isZeroOrNull

도입된 버전: v20.3.0 인수가 0 또는 NULL인지 확인합니다. 구문
인수
  • x — 숫자 값입니다. UInt
반환 값 xNULL이거나 0이면 1을 반환하고, 그렇지 않으면 0을 반환합니다. UInt8/16/32/64 또는 Float32/Float64 예시 사용 예시
Query
Response

nullIf

도입 버전: v1.1.0 두 인수가 같으면 NULL을 반환합니다. 구문
인수
  • x — 첫 번째 값입니다. Any
  • y — 두 번째 값입니다. Any
반환 값 두 인수가 같으면 NULL을 반환하고, 그렇지 않으면 첫 번째 인수를 반환합니다. NULL 또는 Nullable(x) 예시 사용 예시
Query
Response

toNullable

도입 버전: v1.1.0 주어진 인수의 유형을 널 허용로 변환합니다. 구문
인수
  • x — 복합 타입이 아닌 임의의 값입니다. Any
반환 값 입력 값을 널 허용 타입으로 반환합니다. Nullable(Any) 예시 사용 예시
Query
Response
마지막 수정일 2026년 7월 2일