原生模式下的 Cloud Firestore 企业版现已推出！了解详情。

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

توابع مقایسه

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

برابر

نحو:

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 برمی‌گرداند.

نود جی اس

const result = await db.pipeline()
  .collection("books")
  .select(field("rating").equal(5).as("hasPerfectRating"))
  .execute();test.firestore.js

Web

const result = await execute(db.pipeline()
  .collection("books")
  .select(field("rating").equal(5).as("hasPerfectRating"))
);test.firestore.js

سویفت

let result = try await db.pipeline()
  .collection("books")
  .select([Field("rating").equal(5).as("hasPerfectRating")])
  .execute()PipelineSnippets.swift

Kotlin

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

Java

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("books")
    .select(field("rating").equal(5).alias("hasPerfectRating"))
    .execute();DocSnippets.java

پایتون

from google.cloud.firestore_v1.pipeline_expressions import Field

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

جاوا

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("books")
        .select(equal(field("rating"), 5).as("hasPerfectRating"))
        .execute()
        .get();PipelineSnippets.java

برو

snapshot := client.Pipeline().
	Collection("books").
	Select(firestore.Fields(
		firestore.Equal(firestore.FieldOf("rating"), 5).As("hasPerfectRating"),
	)).
	Execute(ctx)pipeline_snippets_comparison.go

بزرگتر از

نحو:

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`

نود جی اس

const result = await db.pipeline()
  .collection("books")
  .select(field("rating").greaterThan(4).as("hasHighRating"))
  .execute();test.firestore.js

Web

const result = await execute(db.pipeline()
  .collection("books")
  .select(field("rating").greaterThan(4).as("hasHighRating"))
);test.firestore.js

سویفت

let result = try await db.pipeline()
  .collection("books")
  .select([Field("rating").greaterThan(4).as("hasHighRating")])
  .execute()PipelineSnippets.swift

Kotlin

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

Java

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("books")
    .select(field("rating").greaterThan(4).alias("hasHighRating"))
    .execute();DocSnippets.java

پایتون

from google.cloud.firestore_v1.pipeline_expressions import Field

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

جاوا

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("books")
        .select(greaterThan(field("rating"), 4).as("hasHighRating"))
        .execute()
        .get();PipelineSnippets.java

برو

snapshot := client.Pipeline().
	Collection("books").
	Select(firestore.Fields(
		firestore.GreaterThan(firestore.FieldOf("rating"), 4).As("hasHighRating"),
	)).
	Execute(ctx)pipeline_snippets_comparison.go

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

نحو:

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`

نود جی اس

const result = await db.pipeline()
  .collection("books")
  .select(field("published").greaterThanOrEqual(1900).as("publishedIn20thCentury"))
  .execute();test.firestore.js

Web

const result = await execute(db.pipeline()
  .collection("books")
  .select(field("published").greaterThanOrEqual(1900).as("publishedIn20thCentury"))
);test.firestore.js

سویفت

let result = try await db.pipeline()
  .collection("books")
  .select([Field("published").greaterThanOrEqual(1900).as("publishedIn20thCentury")])
  .execute()PipelineSnippets.swift

Kotlin

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

Java

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("books")
    .select(field("published").greaterThanOrEqual(1900).alias("publishedIn20thCentury"))
    .execute();DocSnippets.java

پایتون

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()
)firestore_pipelines.py

جاوا

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("books")
        .select(greaterThanOrEqual(field("published"), 1900).as("publishedIn20thCentury"))
        .execute()
        .get();PipelineSnippets.java

برو

snapshot := client.Pipeline().
	Collection("books").
	Select(firestore.Fields(
		firestore.GreaterThanOrEqual(firestore.FieldOf("published"), 1900).As("publishedIn20thCentury"),
	)).
	Execute(ctx)pipeline_snippets_comparison.go

کمتر از

نحو:

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`

نود جی اس

const result = await db.pipeline()
  .collection("books")
  .select(field("published").lessThan(1923).as("isPublicDomainProbably"))
  .execute();test.firestore.js

Web

const result = await execute(db.pipeline()
  .collection("books")
  .select(field("published").lessThan(1923).as("isPublicDomainProbably"))
);test.firestore.js

سویفت

let result = try await db.pipeline()
  .collection("books")
  .select([Field("published").lessThan(1923).as("isPublicDomainProbably")])
  .execute()PipelineSnippets.swift

Kotlin

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

Java

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("books")
    .select(field("published").lessThan(1923).alias("isPublicDomainProbably"))
    .execute();DocSnippets.java

پایتون

from google.cloud.firestore_v1.pipeline_expressions import Field

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

جاوا

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("books")
        .select(lessThan(field("published"), 1923).as("isPublicDomainProbably"))
        .execute()
        .get();PipelineSnippets.java

برو

snapshot := client.Pipeline().
	Collection("books").
	Select(firestore.Fields(
		firestore.LessThan(firestore.FieldOf("published"), 1923).As("isPublicDomainProbably"),
	)).
	Execute(ctx)pipeline_snippets_comparison.go

کمتر یا مساوی

نحو:

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`

نود جی اس

const result = await db.pipeline()
  .collection("books")
  .select(field("rating").lessThanOrEqual(2).as("hasBadRating"))
  .execute();test.firestore.js

Web

const result = await execute(db.pipeline()
  .collection("books")
  .select(field("rating").lessThanOrEqual(2).as("hasBadRating"))
);test.firestore.js

سویفت

let result = try await db.pipeline()
  .collection("books")
  .select([Field("rating").lessThanOrEqual(2).as("hasBadRating")])
  .execute()PipelineSnippets.swift

Kotlin

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

Java

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("books")
    .select(field("rating").lessThanOrEqual(2).alias("hasBadRating"))
    .execute();DocSnippets.java

پایتون

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()
)firestore_pipelines.py

جاوا

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("books")
        .select(lessThanOrEqual(field("rating"), 2).as("hasBadRating"))
        .execute()
        .get();PipelineSnippets.java

برو

snapshot := client.Pipeline().
	Collection("books").
	Select(firestore.Fields(
		firestore.LessThanOrEqual(firestore.FieldOf("rating"), 2).As("hasBadRating"),
	)).
	Execute(ctx)pipeline_snippets_comparison.go

برابر نیست

نحو:

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`

نود جی اس

const result = await db.pipeline()
  .collection("books")
  .select(field("title").notEqual("1984").as("not1984"))
  .execute();test.firestore.js

Web

const result = await execute(db.pipeline()
  .collection("books")
  .select(field("title").notEqual("1984").as("not1984"))
);test.firestore.js

سویفت

let result = try await db.pipeline()
  .collection("books")
  .select([Field("title").notEqual("1984").as("not1984")])
  .execute()PipelineSnippets.swift

Kotlin

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

Java

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("books")
    .select(field("title").notEqual("1984").alias("not1984"))
    .execute();DocSnippets.java

پایتون

from google.cloud.firestore_v1.pipeline_expressions import Field

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

جاوا

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("books")
        .select(notEqual(field("title"), "1984").as("not1984"))
        .execute()
        .get();PipelineSnippets.java

برو

snapshot := client.Pipeline().
	Collection("books").
	Select(firestore.Fields(
		firestore.NotEqual(firestore.FieldOf("title"), "1984").As("not1984"),
	)).
	Execute(ctx)pipeline_snippets_comparison.go

سی ام پی

نحو:

cmp(x: ANY, y: ANY) -> Int64

شرح:

x و y را با هم مقایسه می‌کند و نتیجه را برمی‌گرداند:

1L اگر x از y بزرگتر باشد.
-1L اگر x کمتر از y باشد.
در غیر این صورت 0L .

برخلاف سایر توابع مقایسه، تابع cmp(...) برای انواع مختلف کار می‌کند و از همان ترتیبی که در مرحله sort(...) استفاده می‌شود، پیروی می‌کند. برای نحوه مرتب‌سازی مقادیر بین انواع مختلف، به ترتیب نوع مقدار مراجعه کنید.

مثال‌ها:

`x`	`y`	`cmp(x, y)`
۱ لیتر	۱ لیتر	0 لیتر
۱.۰	۱ لیتر	0 لیتر
-۱.۰	۱ لیتر	-1 لیتر
۴۲.۵ دی	"فو"	-1 لیتر
`NULL`	`NULL`	0 لیتر
`NULL`	`ABSENT`	0 لیتر

توابع مقایسه با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.