توابع مقایسه
| نام | توضیحات |
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() )