범위

설명

import

import { Range } from "@tai-kun/surrealdb/decodeonly-datatypes";
import { Range } from "@tai-kun/surrealdb/encodable-datatypes";
import { Range } from "@tai-kun/surrealdb/standard-datatypes";

.constructor()

새로운 Range 객체를 생성합니다.

new Range(
  source: [
    begin: BoundIncluded | BoundExcluded | null,
    end: BoundIncluded | BoundExcluded | null,
  ],
);

인수

source

범위의 최솟값과 최댓값의 쌍입니다. 무제한인 경우 null입니다.

반환값

new를 통해 호출된 경우, Range는 해당 인스턴스를 반환합니다.

.begin 인스턴스 속성 >=decode-only

범위의 최솟값입니다. 하한이 없는 경우 null입니다.

.begin: BoundIncluded | BoundExcluded | null;

.end 인스턴스 속성 >=decode-only

범위의 최댓값입니다. 상한이 없는 경우 null입니다.

.end: BoundIncluded | BoundExcluded | null;

.toString() 인스턴스 메서드 >=encodable

Range 객체를 SurrealQL에서 사용 가능한 문자열로 변환합니다.

.toJSON()과 .toSurql()은 이 메서드와 동일한 결과를 반환합니다.

.toString(): string;

인수

없음.

반환값

범위의 문자열 표현을 반환합니다.

예

import {
  Range,
  BoundIncluded,
  BoundExcluded,
} from "@tai-kun/surrealdb/encodable-datatypes";

const range = new Range([new BoundIncluded(1), new BoundIncluded(3)]);
console.log(range.toString());
// -> 1..=3

const range = new Range([new BoundExcluded(1), new BoundExcluded(3)]);
console.log(range.toString());
// -> 1>..3

const range = new Range([new BoundIncluded(1), new BoundExcluded(3)]);
console.log(range.toString());
// -> 1..3

const range = new Range([new BoundIncluded(1), null]);
console.log(range.toString());
// -> 1..

const range = new Range([null, new BoundExcluded(3)]);
console.log(range.toString());
// -> ..3

const range = new Range([new BoundExcluded(1), new BoundIncluded(3)]);
console.log(range.toString());
// -> 1>..=3

const range = new Range([new BoundExcluded(1), null]);
console.log(range.toString());
// -> 1>..

const range = new Range([null, new BoundIncluded(3)]);
console.log(range.toString());
// -> ..=3

const range = new Range([null, null]);
console.log(range.toString());
// -> ..

추가 설명

Range 객체의 일반적인 판정

프리셋에 의존하지 않고 값이 Range 객체인지 판정하려면 isRange 함수를 사용하는 것을 권장합니다. 이 함수는 instanceof를 사용하지 않으므로, 검증할 값의 프리셋이 불명확한 경우에 유용합니다.

import { isRange } from "@tai-kun/surrealdb";