توابع مقایسه

توابع مقایسه

نام توضیحات
EQUAL مقایسه برابری
GREATER_THAN بزرگتر از مقایسه
GREATER_THAN_OR_EQUAL مقایسه بزرگتر یا مساوی
LESS_THAN کمتر از مقایسه
LESS_THAN_OR_EQUAL مقایسه کوچکتر یا مساوی
NOT_EQUAL مقایسه برابر نیست

برابر

نحو:

equal(x: ANY, y: ANY) -> BOOLEAN

مثال‌ها:

x y equal(x, y)
۱ لیتر ۱ لیتر TRUE
۱.۰ ۱ لیتر TRUE
-۱.۰ ۱ لیتر FALSE
نان ن نان ن TRUE
NULL NULL TRUE
NULL ABSENT FALSE

شرح:

اگر x و y برابر باشند، TRUE و در غیر این صورت FALSE برمی‌گرداند.

Web

const result = await execute(db.pipeline()
  .collection("books")
  .select(field("rating").equal(5).as("hasPerfectRating"))
);
سویفت
let result = try await db.pipeline()
  .collection("books")
  .select([Field("rating").equal(5).as("hasPerfectRating")])
  .execute()

Kotlin

val result = db.pipeline()
    .collection("books")
    .select(field("rating").equal(5).alias("hasPerfectRating"))
    .execute()

Java

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("books")
    .select(field("rating").equal(5).alias("hasPerfectRating"))
    .execute();
پایتون
from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("books")
    .select(Field.of("rating").equal(5).as_("hasPerfectRating"))
    .execute()
)

بزرگتر از

نحو:

greater_than(x: ANY, y: ANY) -> BOOLEAN

شرح:

اگر x از y بزرگتر باشد، TRUE و در غیر این صورت FALSE برمی‌گرداند.

اگر x و y قابل مقایسه نباشند، FALSE را برمی‌گرداند.

مثال‌ها:

x y greater_than(x, y)
۱ لیتر ۰.۰ TRUE
۱ لیتر ۱ لیتر FALSE
۱ لیتر ۲ لیتر FALSE
"فو" 0 لیتر FALSE
0 لیتر "فو" FALSE
نان ن 0 لیتر FALSE
0 لیتر نان ن FALSE
NULL NULL FALSE

Web

const result = await execute(db.pipeline()
  .collection("books")
  .select(field("rating").greaterThan(4).as("hasHighRating"))
);
سویفت
let result = try await db.pipeline()
  .collection("books")
  .select([Field("rating").greaterThan(4).as("hasHighRating")])
  .execute()

Kotlin

val result = db.pipeline()
    .collection("books")
    .select(field("rating").greaterThan(4).alias("hasHighRating"))
    .execute()

Java

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("books")
    .select(field("rating").greaterThan(4).alias("hasHighRating"))
    .execute();
پایتون
from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("books")
    .select(Field.of("rating").greater_than(4).as_("hasHighRating"))
    .execute()
)

بزرگتر_از_یا_برابر

نحو:

greater_than_or_equal(x: ANY, y: ANY) -> BOOLEAN

شرح:

اگر x بزرگتر یا مساوی y باشد، TRUE و در غیر این صورت FALSE برمی‌گرداند.

اگر x و y قابل مقایسه نباشند، FALSE را برمی‌گرداند.

مثال‌ها:

x y greater_than_or_equal(x, y)
۱ لیتر ۰.۰ TRUE
۱ لیتر ۱ لیتر TRUE
۱ لیتر ۲ لیتر FALSE
"فو" 0 لیتر FALSE
0 لیتر "فو" FALSE
نان ن 0 لیتر FALSE
0 لیتر نان ن FALSE
NULL NULL TRUE

Web

const result = await execute(db.pipeline()
  .collection("books")
  .select(field("published").greaterThanOrEqual(1900).as("publishedIn20thCentury"))
);
سویفت
let result = try await db.pipeline()
  .collection("books")
  .select([Field("published").greaterThanOrEqual(1900).as("publishedIn20thCentury")])
  .execute()

Kotlin

val result = db.pipeline()
    .collection("books")
    .select(field("published").greaterThanOrEqual(1900).alias("publishedIn20thCentury"))
    .execute()

Java

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("books")
    .select(field("published").greaterThanOrEqual(1900).alias("publishedIn20thCentury"))
    .execute();
پایتون
from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("books")
    .select(
        Field.of("published")
        .greater_than_or_equal(1900)
        .as_("publishedIn20thCentury")
    )
    .execute()
)

کمتر از

نحو:

less_than(x: ANY, y: ANY) -> BOOLEAN

شرح:

اگر x از y کوچکتر باشد، TRUE و در غیر این صورت FALSE برمی‌گرداند.

اگر x و y قابل مقایسه نباشند، FALSE را برمی‌گرداند.

مثال‌ها:

x y less_than(x, y)
۱ لیتر ۰.۰ FALSE
۱ لیتر ۱ لیتر FALSE
۱ لیتر ۲ لیتر TRUE
"فو" 0 لیتر FALSE
0 لیتر "فو" FALSE
نان ن 0 لیتر FALSE
0 لیتر نان ن FALSE
NULL NULL FALSE

Web

const result = await execute(db.pipeline()
  .collection("books")
  .select(field("published").lessThan(1923).as("isPublicDomainProbably"))
);
سویفت
let result = try await db.pipeline()
  .collection("books")
  .select([Field("published").lessThan(1923).as("isPublicDomainProbably")])
  .execute()

Kotlin

val result = db.pipeline()
    .collection("books")
    .select(field("published").lessThan(1923).alias("isPublicDomainProbably"))
    .execute()

Java

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("books")
    .select(field("published").lessThan(1923).alias("isPublicDomainProbably"))
    .execute();
پایتون
from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("books")
    .select(Field.of("published").less_than(1923).as_("isPublicDomainProbably"))
    .execute()
)

کمتر یا مساوی

نحو:

less_than_or_equal(x: ANY, y: ANY) -> BOOLEAN

شرح:

اگر x کوچکتر یا مساوی y باشد، TRUE و در غیر این صورت FALSE برمی‌گرداند.

اگر x و y قابل مقایسه نباشند، FALSE را برمی‌گرداند.

مثال‌ها:

x y less_than(x, y)
۱ لیتر ۰.۰ FALSE
۱ لیتر ۱ لیتر TRUE
۱ لیتر ۲ لیتر TRUE
"فو" 0 لیتر FALSE
0 لیتر "فو" FALSE
نان ن 0 لیتر FALSE
0 لیتر نان ن FALSE
NULL NULL TRUE

Web

const result = await execute(db.pipeline()
  .collection("books")
  .select(field("rating").lessThanOrEqual(2).as("hasBadRating"))
);
سویفت
let result = try await db.pipeline()
  .collection("books")
  .select([Field("rating").lessThanOrEqual(2).as("hasBadRating")])
  .execute()

Kotlin

val result = db.pipeline()
    .collection("books")
    .select(field("rating").lessThanOrEqual(2).alias("hasBadRating"))
    .execute()

Java

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("books")
    .select(field("rating").lessThanOrEqual(2).alias("hasBadRating"))
    .execute();
پایتون
from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("books")
    .select(Field.of("rating").less_than_or_equal(2).as_("hasBadRating"))
    .execute()
)

برابر نیست

نحو:

not_equal(x: ANY, y: ANY) -> BOOLEAN

شرح:

اگر x با y برابر نباشد، TRUE و در غیر این صورت FALSE برمی‌گرداند.

مثال‌ها:

x y not_equal(x, y)
۱ لیتر ۱ لیتر FALSE
۱.۰ ۱ لیتر FALSE
-۱.۰ ۱ لیتر TRUE
نان ن 0 لیتر TRUE
نان ن نان ن FALSE
NULL NULL FALSE
NULL ABSENT TRUE

Web

const result = await execute(db.pipeline()
  .collection("books")
  .select(field("title").notEqual("1984").as("not1984"))
);
سویفت
let result = try await db.pipeline()
  .collection("books")
  .select([Field("title").notEqual("1984").as("not1984")])
  .execute()

Kotlin

val result = db.pipeline()
    .collection("books")
    .select(field("title").notEqual("1984").alias("not1984"))
    .execute()

Java

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("books")
    .select(field("title").notEqual("1984").alias("not1984"))
    .execute();
پایتون
from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("books")
    .select(Field.of("title").not_equal("1984").as_("not1984"))
    .execute()
)