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

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

توابع رشته

پیش‌نمایش: فایراستور در حالت بومی (با عملیات خط لوله) برای نسخه سازمانی، تابع «شرایط ارائه‌های پیش از GA» در بخش شرایط عمومی خدمات از شرایط خاص خدمات است. شما می‌توانید داده‌های شخصی را برای این ویژگی، همانطور که در ضمیمه پردازش داده‌های ابری ذکر شده است، پردازش کنید، مشروط بر تعهدات و محدودیت‌های شرح داده شده در توافق‌نامه‌ای که تحت آن به Google Cloud دسترسی دارید. ویژگی‌های پیش از GA «به همین صورت موجود» در دسترس هستند و ممکن است پشتیبانی محدودی داشته باشند. برای اطلاعات بیشتر، به توضیحات مرحله راه‌اندازی مراجعه کنید.

توابع رشته‌ای

نام	توضیحات
`BYTE_LENGTH`	تعداد `BYTES` در یک مقدار `STRING` یا `BYTES` را برمی‌گرداند.
`CHAR_LENGTH`	تعداد کاراکترهای یونیکد در یک مقدار `STRING` را برمی‌گرداند
`STARTS_WITH`	اگر یک `STRING` با پیشوند داده شده شروع شود، `TRUE` را برمی‌گرداند.
`ENDS_WITH`	اگر یک `STRING` با پسوند مشخص شده پایان یابد `TRUE` را برمی‌گرداند.
`LIKE`	اگر یک `STRING` با الگو مطابقت داشته باشد، `TRUE` را برمی‌گرداند.
`REGEX_CONTAINS`	اگر مقداری با یک عبارت منظم مطابقت جزئی یا کامل داشته باشد، `TRUE` را برمی‌گرداند.
`REGEX_MATCH`	اگر هر بخشی از یک مقدار با یک عبارت منظم مطابقت داشته باشد، `TRUE` برمی‌گرداند.
`STRING_CONCAT`	چندین `STRING` به هم متصل کرده و یک `STRING` ایجاد می‌کند.
`STRING_CONTAINS`	اگر مقدار شامل یک `STRING` باشد، `TRUE` برمی‌گرداند.
`STRING_INDEX_OF`	ایندکس مبتنی بر 0 اولین وقوع یک مقدار `STRING` یا `BYTES` را برمی‌گرداند.
`TO_UPPER`	یک مقدار `STRING` یا `BYTES` را به حروف بزرگ تبدیل می‌کند.
`TO_LOWER`	یک مقدار `STRING` یا `BYTES` را به حروف کوچک تبدیل می‌کند.
`SUBSTRING`	یک زیررشته از یک مقدار `STRING` یا `BYTES` دریافت می‌کند.
`STRING_REVERSE`	مقدار `STRING` یا `BYTES` را معکوس می‌کند.
`STRING_REPEAT`	یک مقدار `STRING` یا `BYTES` را به تعداد دفعات مشخص تکرار می‌کند.
`STRING_REPLACE_ALL`	تمام موارد وقوع یک مقدار `STRING` یا `BYTES` را جایگزین می‌کند.
`STRING_REPLACE_ONE`	اولین مورد از یک مقدار `STRING` یا `BYTES` را جایگزین می‌کند.
`TRIM`	کاراکترهای اول و آخر یک مقدار `STRING` یا `BYTES` را حذف می‌کند.
`LTRIM`	کاراکترهای ابتدای یک مقدار `STRING` یا `BYTES` را حذف می‌کند.
`RTRIM`	کاراکترهای انتهایی یک مقدار `STRING` یا `BYTES` را حذف می‌کند.
`SPLIT`	یک مقدار `STRING` یا `BYTES` را به یک آرایه تقسیم می‌کند.

طول بایت

نحو:

byte_length[T <: STRING | BYTES](value: T) -> INT64

شرح:

تعداد BYTES در یک مقدار STRING یا BYTES را برمی‌گرداند.

مثال‌ها:

ارزش	`byte_length(value)`
"ای بی سی"	۳
"xyzabc"	۶
ب"الفبا"	۳

نود جی اس

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

Web

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

سویفت

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

Kotlin

val result = db.pipeline()
    .collection("books")
    .select(
        field("title").byteLength().alias("titleByteLength")
    )
    .execute()DocSnippets.kt

Java

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

پایتون

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("books")
    .select(Field.of("title").byte_length().as_("titleByteLength"))
    .execute()
)firestore_pipelines.py

جاوا

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("books")
        .select(byteLength(field("title")).as("titleByteLength"))
        .execute()
        .get();PipelineSnippets.java

طول کاراکتر

نحو:

char_length(value: STRING) -> INT64

شرح:

تعداد نقاط کد یونیکد را در مقدار STRING برمی‌گرداند.

مثال‌ها:

ارزش	`char_length(value)`
"ای بی سی"	۳
«سلام»	۵
«جهان»	۵

نود جی اس

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

Web

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

سویفت

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

Kotlin

val result = db.pipeline()
    .collection("books")
    .select(
        field("title").charLength().alias("titleCharLength")
    )
    .execute()DocSnippets.kt

Java

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

پایتون

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("books")
    .select(Field.of("title").char_length().as_("titleCharLength"))
    .execute()
)firestore_pipelines.py

جاوا

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("books")
        .select(charLength(field("title")).as("titleCharLength"))
        .execute()
        .get();PipelineSnippets.java

شروع_با

نحو:

starts_with(value: STRING, prefix: STRING) -> BOOLEAN

شرح:

اگر value با prefix شروع شود، TRUE برمی‌گرداند.

مثال‌ها:

ارزش	پیشوند	`starts_with(value, prefix)`
"ای بی سی"	«الف»	درست
"ای بی سی"	«ب»	نادرست
"ای بی سی"	«»	درست

نود جی اس

const result = await db.pipeline()
  .collection("books")
  .select(
    field("title").startsWith("The")
      .as("needsSpecialAlphabeticalSort")
  )
  .execute();test.firestore.js

Web

const result = await execute(db.pipeline()
  .collection("books")
  .select(
    field("title").startsWith("The")
      .as("needsSpecialAlphabeticalSort")
  )
);test.firestore.js

سویفت

let result = try await db.pipeline()
  .collection("books")
  .select([
    Field("title").startsWith("The")
      .as("needsSpecialAlphabeticalSort")
  ])
  .execute()PipelineSnippets.swift

Kotlin

val result = db.pipeline()
    .collection("books")
    .select(
        field("title").startsWith("The")
            .alias("needsSpecialAlphabeticalSort")
    )
    .execute()DocSnippets.kt

Java

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("books")
    .select(
        field("title").startsWith("The")
            .alias("needsSpecialAlphabeticalSort")
    )
    .execute();DocSnippets.java

پایتون

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("books")
    .select(
        Field.of("title").starts_with("The").as_("needsSpecialAlphabeticalSort")
    )
    .execute()
)firestore_pipelines.py

جاوا

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("books")
        .select(startsWith(field("title"), "The").as("needsSpecialAlphabeticalSort"))
        .execute()
        .get();PipelineSnippets.java

پایان_با

نحو:

ends_with(value: STRING, postfix: STRING) -> BOOLEAN

شرح:

اگر value با postfix خاتمه یابد، TRUE را برمی‌گرداند.

مثال‌ها:

ارزش	پسوند	`ends_with(value, postfix)`
"ای بی سی"	«سی»	درست
"ای بی سی"	«ب»	نادرست
"ای بی سی"	«»	درست

نود جی اس

const result = await db.pipeline()
  .collection("inventory/devices/laptops")
  .select(
    field("name").endsWith("16 inch")
      .as("16InLaptops")
  )
  .execute();test.firestore.js

سویفت

let result = try await db.pipeline()
  .collection("inventory/devices/laptops")
  .select([
    Field("name").endsWith("16 inch")
      .as("16InLaptops")
  ])
  .execute()PipelineSnippets.swift

Kotlin

val result = db.pipeline()
    .collection("inventory/devices/laptops")
    .select(
        field("name").endsWith("16 inch")
            .alias("16InLaptops")
    )
    .execute()DocSnippets.kt

Java

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("inventory/devices/laptops")
    .select(
        field("name").endsWith("16 inch")
            .alias("16InLaptops")
    )
    .execute();DocSnippets.java

پایتون

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("inventory/devices/laptops")
    .select(Field.of("name").ends_with("16 inch").as_("16InLaptops"))
    .execute()
)firestore_pipelines.py

جاوا

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("inventory/devices/laptops")
        .select(endsWith(field("name"), "16 inch").as("16InLaptops"))
        .execute()
        .get();PipelineSnippets.java

لایک

نحو:

like(value: STRING, pattern: STRING) -> BOOLEAN

شرح:

اگر value با pattern مطابقت داشته باشد، TRUE را برمی‌گرداند.

مثال‌ها:

ارزش	الگو	`like(value, pattern)`
«آتش‌نشانی»	"آتش٪"	درست
«آتش‌نشانی»	"%فروشگاه"	درست
«انبار داده»	"داده_ذخیره"	درست
«۱۰۰٪»	"۱۰۰٪"	درست

نود جی اس

const result = await db.pipeline()
  .collection("books")
  .select(
    field("genre").like("%Fiction")
      .as("anyFiction")
  )
  .execute();test.firestore.js

Web

const result = await execute(db.pipeline()
  .collection("books")
  .select(
    field("genre").like("%Fiction")
      .as("anyFiction")
  )
);test.firestore.js

سویفت

let result = try await db.pipeline()
  .collection("books")
  .select([
    Field("genre").like("%Fiction")
      .as("anyFiction")
  ])
  .execute()PipelineSnippets.swift

Kotlin

val result = db.pipeline()
    .collection("books")
    .select(
        field("genre").like("%Fiction")
            .alias("anyFiction")
    )
    .execute()DocSnippets.kt

Java

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("books")
    .select(
        field("genre").like("%Fiction")
            .alias("anyFiction")
    )
    .execute();DocSnippets.java

پایتون

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("books")
    .select(Field.of("genre").like("%Fiction").as_("anyFiction"))
    .execute()
)firestore_pipelines.py

جاوا

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("books")
        .select(like(field("genre"), "%Fiction").as("anyFiction"))
        .execute()
        .get();PipelineSnippets.java

مقادیر منظم (REGEX_CONTAINS)

نحو:

regex_contains(value: STRING, pattern: STRING) -> BOOLEAN

شرح:

اگر بخشی از value pattern مطابقت داشته باشد، TRUE برمی‌گرداند. اگر pattern یک عبارت منظم معتبر نباشد، این تابع error برمی‌گرداند.

عبارات منظم از سینتکس کتابخانه re2 پیروی می‌کنند.

مثال‌ها:

ارزش	الگو	`regex_contains(value, pattern)`
«آتش‌نشانی»	«آتش»	درست
«آتش‌نشانی»	"فروشگاه $"	درست
«آتش‌نشانی»	«داده‌ها»	نادرست

نود جی اس

const result = await db.pipeline()
  .collection("documents")
  .select(
    field("title").regexContains("Firestore (Enterprise|Standard)")
      .as("isFirestoreRelated")
  )
  .execute();test.firestore.js

Web

const result = await execute(db.pipeline()
  .collection("documents")
  .select(
    field("title").regexContains("Firestore (Enterprise|Standard)")
      .as("isFirestoreRelated")
  )
);test.firestore.js

سویفت

let result = try await db.pipeline()
  .collection("documents")
  .select([
    Field("title").regexContains("Firestore (Enterprise|Standard)")
      .as("isFirestoreRelated")
  ])
  .execute()PipelineSnippets.swift

Kotlin

val result = db.pipeline()
    .collection("documents")
    .select(
        field("title").regexContains("Firestore (Enterprise|Standard)")
            .alias("isFirestoreRelated")
    )
    .execute()DocSnippets.kt

Java

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("documents")
    .select(
        field("title").regexContains("Firestore (Enterprise|Standard)")
            .alias("isFirestoreRelated")
    )
    .execute();DocSnippets.java

پایتون

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("documents")
    .select(
        Field.of("title")
        .regex_contains("Firestore (Enterprise|Standard)")
        .as_("isFirestoreRelated")
    )
    .execute()
)firestore_pipelines.py

جاوا

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("documents")
        .select(
            regexContains(field("title"), "Firestore (Enterprise|Standard)")
                .as("isFirestoreRelated"))
        .execute()
        .get();PipelineSnippets.java

تطبیق_عبارت_عبارت_مرتب

نحو:

regex_match(value: STRING, pattern: STRING) -> BOOLEAN

شرح:

اگر value کاملاً با pattern مطابقت داشته باشد، TRUE برمی‌گرداند. اگر pattern یک عبارت منظم معتبر نباشد، این تابع error برمی‌گرداند.

عبارات منظم از سینتکس کتابخانه re2 پیروی می‌کنند.

مثال‌ها:

ارزش	الگو	`regex_match(value, pattern)`
«آتش‌نشانی»	«فروشگاه اف.»	درست
«آتش‌نشانی»	«آتش»	نادرست
«آتش‌نشانی»	"^F.*e$"	درست

نود جی اس

const result = await db.pipeline()
  .collection("documents")
  .select(
    field("title").regexMatch("Firestore (Enterprise|Standard)")
      .as("isFirestoreExactly")
  )
  .execute();test.firestore.js

Web

const result = await execute(db.pipeline()
  .collection("documents")
  .select(
    field("title").regexMatch("Firestore (Enterprise|Standard)")
      .as("isFirestoreExactly")
  )
);test.firestore.js

سویفت

let result = try await db.pipeline()
  .collection("documents")
  .select([
    Field("title").regexMatch("Firestore (Enterprise|Standard)")
      .as("isFirestoreExactly")
  ])
  .execute()PipelineSnippets.swift

Kotlin

val result = db.pipeline()
    .collection("documents")
    .select(
        field("title").regexMatch("Firestore (Enterprise|Standard)")
            .alias("isFirestoreExactly")
    )
    .execute()DocSnippets.kt

Java

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("documents")
    .select(
        field("title").regexMatch("Firestore (Enterprise|Standard)")
            .alias("isFirestoreExactly")
    )
    .execute();DocSnippets.java

پایتون

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("documents")
    .select(
        Field.of("title")
        .regex_match("Firestore (Enterprise|Standard)")
        .as_("isFirestoreExactly")
    )
    .execute()
)firestore_pipelines.py

جاوا

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("documents")
        .select(
            regexMatch(field("title"), "Firestore (Enterprise|Standard)")
                .as("isFirestoreExactly"))
        .execute()
        .get();PipelineSnippets.java

رشته_متصل

نحو:

string_concat(values: STRING...) -> STRING

شرح:

دو یا چند مقدار STRING را به یک نتیجه واحد پیوند می‌دهد.

مثال‌ها:

استدلال‌ها	`string_concat(values...)`
`()`	خطا
`("a")`	«الف»
`("abc", "def")`	"الف ب دف"
`("a", "", "c")`	"آ سی"

نود جی اس

const result = await db.pipeline()
  .collection("books")
  .select(
    field("title").stringConcat(" by ", field("author"))
      .as("fullyQualifiedTitle")
  )
  .execute();test.firestore.js

Web

const result = await execute(db.pipeline()
  .collection("books")
  .select(
    field("title").stringConcat(" by ", field("author"))
      .as("fullyQualifiedTitle")
  )
);test.firestore.js

سویفت

let result = try await db.pipeline()
  .collection("books")
  .select([
    Field("title").concat([" by ", Field("author")])
      .as("fullyQualifiedTitle")
  ])
  .execute()PipelineSnippets.swift

Kotlin

val result = db.pipeline()
    .collection("books")
    .select(
        field("title").concat(" by ", field("author"))
            .alias("fullyQualifiedTitle")
    )
    .execute()DocSnippets.kt

Java

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("books")
    .select(
        field("title").concat(" by ", field("author"))
            .alias("fullyQualifiedTitle")
    )
    .execute();DocSnippets.java

پایتون

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("books")
    .select(
        Field.of("title")
        .concat(" by ", Field.of("author"))
        .as_("fullyQualifiedTitle")
    )
    .execute()
)firestore_pipelines.py

جاوا

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("books")
        .select(stringConcat(field("title"), " by ", field("author")).as("fullyQualifiedTitle"))
        .execute()
        .get();PipelineSnippets.java

محتویات رشته

نحو:

string_contains(value: STRING, substring: STRING) -> BOOLEAN

شرح:

بررسی می‌کند که آیا value شامل substring String به صورت تحت‌اللفظی است یا خیر.

مثال‌ها:

ارزش	زیررشته	`string_contains(value, substring)`
"ای بی سی"	«ب»	درست
"ای بی سی"	«دی»	نادرست
"ای بی سی"	«»	درست
"آ سی"	«.»	درست
«☃☃☃»	«☃»	درست

نود جی اس

const result = await db.pipeline()
  .collection("articles")
  .select(
    field("body").stringContains("Firestore")
      .as("isFirestoreRelated")
  )
  .execute();test.firestore.js

Web

const result = await execute(db.pipeline()
  .collection("articles")
  .select(
    field("body").stringContains("Firestore")
      .as("isFirestoreRelated")
  )
);test.firestore.js

سویفت

let result = try await db.pipeline()
  .collection("articles")
  .select([
    Field("body").stringContains("Firestore")
      .as("isFirestoreRelated")
  ])
  .execute()PipelineSnippets.swift

Kotlin

val result = db.pipeline()
    .collection("articles")
    .select(
        field("body").stringContains("Firestore")
            .alias("isFirestoreRelated")
    )
    .execute()DocSnippets.kt

Java

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("articles")
    .select(
        field("body").stringContains("Firestore")
            .alias("isFirestoreRelated")
    )
    .execute();DocSnippets.java

پایتون

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("articles")
    .select(Field.of("body").string_contains("Firestore").as_("isFirestoreRelated"))
    .execute()
)firestore_pipelines.py

جاوا

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("articles")
        .select(stringContains(field("body"), "Firestore").as("isFirestoreRelated"))
        .execute()
        .get();PipelineSnippets.java

STRING_INDEX_OF

نحو:

string_index_of[T <: STRING | BYTES](value: T, search: T) -> INT64

شرح:

ایندکس مبتنی بر ۰ اولین رخداد search در value را برمی‌گرداند.

اگر search پیدا نشود، -1 را برمی‌گرداند.
اگر value یک مقدار STRING باشد، نتیجه بر حسب امتیاز کد یونیکد اندازه‌گیری می‌شود. اگر مقدار یک مقدار BYTES باشد، بر حسب بایت اندازه‌گیری می‌شود.
اگر search یک مقدار STRING یا BYTES خالی باشد، نتیجه 0 است.

مثال‌ها:

ارزش	جستجو	`string_index_of(value, search)`
"سلام دنیا"	«ای»	۴
"سلام دنیا"	«ل»	۲
"سلام دنیا"	«ز»	-1
«موز»	«نا»	۲
"ای بی سی"	«»	0
ب"الفبا"	ب "ب"	۱
"ه"	"ه"	0
ب "é"	ب "é"	0

به بالا

نحو:

to_upper[T <: STRING | BYTES](value: T) -> T

شرح:

یک مقدار STRING یا BYTES را به حروف بزرگ تبدیل می‌کند.

اگر یک بایت یا کاراکتر با یک کاراکتر الفبایی کوچک UTF-8 مطابقت نداشته باشد، بدون تغییر منتقل می‌شود.

مثال‌ها:

ارزش	`to_upper(value)`
"ای بی سی"	«ای‌بی‌سی»
«ای‌بی‌سی»	«ای‌بی‌سی»
ب"الفبا"	ب "ای بی سی"
ب"آ۱سی"	ب "A1C"

نود جی اس

const result = await db.pipeline()
  .collection("authors")
  .select(
    field("name").toUpper()
      .as("uppercaseName")
  )
  .execute();test.firestore.js

Web

const result = await execute(db.pipeline()
  .collection("authors")
  .select(
    field("name").toUpper()
      .as("uppercaseName")
  )
);test.firestore.js

سویفت

let result = try await db.pipeline()
  .collection("authors")
  .select([
    Field("name").toUpper()
      .as("uppercaseName")
  ])
  .execute()PipelineSnippets.swift

Kotlin

val result = db.pipeline()
    .collection("authors")
    .select(
        field("name").toUpper()
            .alias("uppercaseName")
    )
    .execute()DocSnippets.kt

Java

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("authors")
    .select(
        field("name").toUpper()
            .alias("uppercaseName")
    )
    .execute();DocSnippets.java

پایتون

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("authors")
    .select(Field.of("name").to_upper().as_("uppercaseName"))
    .execute()
)firestore_pipelines.py

جاوا

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("authors")
        .select(toUpper(field("name")).as("uppercaseName"))
        .execute()
        .get();PipelineSnippets.java

به پایین

نحو:

to_lower[T <: STRING | BYTES](value: T) -> T

شرح:

یک مقدار STRING یا BYTES را به حروف کوچک تبدیل می‌کند.

اگر یک بایت یا کاراکتر با یک کاراکتر الفبایی بزرگ UTF-8 مطابقت نداشته باشد، بدون تغییر منتقل می‌شود.

مثال‌ها:

ارزش	`to_lower(value)`
«ای‌بی‌سی»	"ای بی سی"
«ای‌بی‌سی»	"ای بی سی"
«ای وان سی»	«ای۱سی»
ب "ای بی سی"	ب"الفبا"

نود جی اس

const result = await db.pipeline()
  .collection("authors")
  .select(
    field("genre").toLower().equal("fantasy")
      .as("isFantasy")
  )
  .execute();test.firestore.js

Web

const result = await execute(db.pipeline()
  .collection("authors")
  .select(
    field("genre").toLower().equal("fantasy")
      .as("isFantasy")
  )
);test.firestore.js

سویفت

let result = try await db.pipeline()
  .collection("authors")
  .select([
    Field("genre").toLower().equal("fantasy")
      .as("isFantasy")
  ])
  .execute()PipelineSnippets.swift

Kotlin

val result = db.pipeline()
    .collection("authors")
    .select(
        field("genre").toLower().equal("fantasy")
            .alias("isFantasy")
    )
    .execute()DocSnippets.kt

Java

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("authors")
    .select(
        field("genre").toLower().equal("fantasy")
            .alias("isFantasy")
    )
    .execute();DocSnippets.java

پایتون

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("authors")
    .select(Field.of("genre").to_lower().equal("fantasy").as_("isFantasy"))
    .execute()
)firestore_pipelines.py

جاوا

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("authors")
        .select(equal(toLower(field("genre")), "fantasy").as("isFantasy"))
        .execute()
        .get();PipelineSnippets.java

زیررشته

نحو:

substring[T <: STRING | BYTES](input: T, position: INT64) -> T
substring[T <: STRING | BYTES](input: T, position: INT64, length: INT64) -> T

شرح:

یک زیررشته از input را با شروع از position (اندیس مبتنی بر صفر) و شامل ورودی‌هایی با حداکثر length ، برمی‌گرداند. اگر length ارائه نشود، زیررشته را از position تا انتهای input برمی‌گرداند.

اگر input یک مقدار STRING باشد، position و length بر حسب نقاط کد یونیکد اندازه‌گیری می‌شوند. اگر مقدار BYTES باشد، بر حسب بایت اندازه‌گیری می‌شوند.
اگر position بزرگتر از طول input باشد، یک زیررشته خالی برگردانده می‌شود. اگر position بعلاوه length بزرگتر از طول input باشد، زیررشته تا انتهای input کوتاه می‌شود.
اگر position منفی باشد، موقعیت از انتهای ورودی گرفته می‌شود. اگر position منفی بزرگتر از اندازه ورودی باشد، موقعیت روی صفر تنظیم می‌شود. length باید غیر منفی باشد.

مثال‌ها:

وقتی length ارائه نشده باشد:

ورودی	موقعیت	`substring(input, position)`
"ای بی سی"	0	"ای بی سی"
"ای بی سی"	۱	"بی سی"
"ای بی سی"	۳	«»
"ای بی سی"	-1	«سی»
ب"الفبا"	۱	بی"بی سی"

وقتی length ارائه می‌شود:

ورودی	موقعیت	طول	`substring(input, position, length)`
"ای بی سی"	0	۱	«الف»
"ای بی سی"	۱	۲	"بی سی"
"ای بی سی"	-1	۱	«سی»
ب"الفبا"	0	۱	ب "الف"

نود جی اس

const result = await db.pipeline()
  .collection("books")
  .where(field("title").startsWith("The "))
  .select(
    field("title").substring(4)
      .as("titleWithoutLeadingThe")
  )
  .execute();test.firestore.js

Web

const result = await execute(db.pipeline()
  .collection("books")
  .where(field("title").startsWith("The "))
  .select(
    field("title").substring(4)
      .as("titleWithoutLeadingThe")
  )
);test.firestore.js

سویفت

let result = try await db.pipeline()
  .collection("books")
  .where(Field("title").startsWith("The "))
  .select([
    Field("title").substring(position: 4)
      .as("titleWithoutLeadingThe")
  ])
  .execute()PipelineSnippets.swift

Kotlin

val result = db.pipeline()
    .collection("books")
    .where(field("title").startsWith("The "))
    .select(
        field("title")
          .substring(constant(4),
            field("title").charLength().subtract(4))
            .alias("titleWithoutLeadingThe")
    )
    .execute()DocSnippets.kt

Java

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("books")
    .where(field("title").startsWith("The "))
    .select(
        field("title").substring(
          constant(4),
            field("title").charLength().subtract(4))
            .alias("titleWithoutLeadingThe")
    )
    .execute();DocSnippets.java

پایتون

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("books")
    .where(Field.of("title").starts_with("The "))
    .select(Field.of("title").substring(4).as_("titleWithoutLeadingThe"))
    .execute()
)firestore_pipelines.py

جاوا

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("books")
        .where(startsWith(field("title"), "The "))
        .select(
            substring(field("title"), constant(4), field("title").charLength())
                .as("titleWithoutLeadingThe"))
        .execute()
        .get();PipelineSnippets.java

معکوس رشته

نحو:

string_reverse[T <: STRING | BYTES](input: T) -> T

شرح:

ورودی ارائه شده را به ترتیب معکوس برمی‌گرداند.

وقتی ورودی یک STRING باشد، کاراکترها توسط نقاط کد یونیکد و وقتی ورودی یک مقدار BYTES باشد، توسط بایت‌ها مشخص می‌شوند.

مثال‌ها:

ورودی	`string_reverse(input)`
"ای بی سی"	"سی بی ای"
"الف🌹ب"	"بی🌹ا"
«سلام»	"الله"
ب"الفبا"	ب"سی بی ای"

نود جی اس

const result = await db.pipeline()
  .collection("books")
  .select(
    field("name").reverse().as("reversedName")
  )
  .execute();test.firestore.js

Web

const result = await execute(db.pipeline()
  .collection("books")
  .select(
    field("name").reverse().as("reversedName")
  )
);test.firestore.js

سویفت

let result = try await db.pipeline()
  .collection("books")
  .select([
    Field("name").reverse().as("reversedName")
  ])
  .execute()PipelineSnippets.swift

Kotlin

val result = db.pipeline()
    .collection("books")
    .select(
        field("name").reverse().alias("reversedName")
    )
    .execute()DocSnippets.kt

Java

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("books")
    .select(
        field("name").reverse().alias("reversedName")
    )
    .execute();DocSnippets.java

پایتون

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("books")
    .select(Field.of("name").string_reverse().as_("reversedName"))
    .execute()
)firestore_pipelines.py

جاوا

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("books")
        .select(reverse(field("name")).as("reversedName"))
        .execute()
        .get();PipelineSnippets.java

تکرار رشته

نحو:

string_repeat[T <: STRING | BYTES](input: T, repetitions: INT64) -> T

شرح:

تعداد repetitions input را برمی‌گرداند.

repetitions باید یک عدد صحیح غیر منفی باشند.
اگر repetitions 0 باشد، یک مقدار خالی از همان نوع input را برمی‌گرداند.
اگر نتیجه از حداکثر اندازه مجاز (۱ مگابایت) بیشتر شود، خطایی برگردانده می‌شود.

مثال‌ها:

ورودی	تکرارها	`string_repeat(input, repetitions)`
"فو"	۳	"فوفوفو"
"فو"	0	«»
«الف»	۳	«آآ»
ب"آب"	۲	ب"باب"
"ه🦆"	۲	"این🦆این🦆"

STRING_REPLACE_ALL

نحو:

string_replace_all[T <: STRING | BYTES](input: T, find: T, replacement: T) -> T

شرح:

تمام رخدادهای غیرهمپوشانی find در input را با replacement جایگزین می‌کند.

تطابق‌ها به حروف کوچک و بزرگ حساس هستند.
اگر find خالی باشد، هیچ جایگزینی انجام نمی‌شود.

مثال‌ها:

ورودی	پیدا کردن	جایگزینی	`string_replace_all(input, find, replacement)`
"فوبارفو"	"فو"	«باز»	«بازبارباز»
«باباب»	«آبا»	«سی»	"کباب"
"فوبار"	«ای»	«»	"فبار"
"ه🦆🌎🦆"	«🦆»	«الف»	"اِا🌎ا"
ب"الفبا"	ب "ب"	ب"د"	ب"adc"

یک رشته را جایگزین کنید

نحو:

string_replace_one[T <: STRING | BYTES](input: T, find: T, replacement: T) -> T

شرح:

اولین مورد از find در input را با replacement جایگزین می‌کند.

تطابق‌ها به حروف کوچک و بزرگ حساس هستند.
اگر find خالی باشد، هیچ جایگزینی انجام نمی‌شود.

مثال‌ها:

ورودی	پیدا کردن	جایگزینی	`string_replace_one(input, find, replacement)`
"فوبارفو"	"فو"	«باز»	"بازبرفو"
"ه"	"ه"	«الف»	«الف»
ب"فوبار"	ب "او"	ب"ز"	ب"فزوبار"

تریم

نحو:

trim[T <: STRING | BYTES](input: T, values_to_trim: T) -> T
trim[T <: STRING | BYTES](input: T) -> T

شرح:

مجموعه‌ای مشخص از BYTES یا CHARS را از ابتدا و انتهای input ارائه شده برش می‌دهد.

اگر هیچ values_to_trim ارائه نشده باشد، کاراکترهای فاصله را حذف می‌کند.

مثال‌ها:

وقتی values_to_trim ارائه نشده باشد:

ورودی	`trim(input)`
"فو"	"فو"
ب" غذا "	ب "غذا"
"فو"	"فو"
«»	«»
« »	«»
"\t غذا \n"	"فو"
ب"\t غذا \n"	ب "غذا"
"\r\f\v غذا \r\f\v"	"فو"
\r\f\v غذا \r\f\v	ب "غذا"

وقتی values_to_trim ارائه می‌شود:

ورودی	مقادیر_به_تریم	`trim(input, values_to_trim)`
"abcbfooaacb"	"ای بی سی"	"فو"
"abcdaabadbac"	"ای بی سی"	«داآباد»
ب"C1C2C3"	ب"سی۱"	ب"سی۲سی۳"
ب"C1C2"	"فو"	خطا
"فو"	ب"سی۱"	خطا

Web

const result = await execute(db.pipeline()
  .collection("books")
  .select(
    field("name").trim().as("whitespaceTrimmedName")
  )
);test.firestore.js

سویفت

let result = try await db.pipeline()
  .collection("books")
  .select([
    Field("name").trim(" \n\t").as("whitespaceTrimmedName")
  ])
  .execute()PipelineSnippets.swift

Kotlin

val result = db.pipeline()
    .collection("books")
    .select(
        field("name").trim().alias("whitespaceTrimmedName")
    )
    .execute()DocSnippets.kt

Java

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("books")
    .select(
        field("name").trim().alias("whitespaceTrimmedName")
    )
    .execute();DocSnippets.java

پایتون

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("books")
    .select(Field.of("name").trim().as_("whitespaceTrimmedName"))
    .execute()
)firestore_pipelines.py

جاوا

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("books")
        .select(trim(field("name")).as("whitespaceTrimmedName"))
        .execute()
        .get();PipelineSnippets.java

لتریم

نحو:

ltrim[T <: STRING | BYTES](value: T, to_trim: T) -> T
ltrim[T <: STRING | BYTES](value: T) -> T

شرح:

مجموعه مشخصی از BYTES یا CHARS را از ابتدای value ارائه شده برش می‌دهد.

اگر to_trim ارائه نشده باشد، کاراکترهای فاصله‌ی ابتدای تابع را حذف می‌کند.

مثال‌ها:

چه زمانی to_trim ارائه نمی‌شود:

ارزش	`ltrim(value)`
"فو"	"فو"
"فو"	"فو"

چه زمانی to_trim ارائه می‌شود:

ارزش	to_trim	`ltrim(value, to_trim)`
"آاِی بی سی"	«الف»	"بی سی"
«آباکابا»	"با"	"کابا"
"ه"	"ه"	«»

آرتریم

نحو:

rtrim[T <: STRING | BYTES](value: T, to_trim: T) -> T
rtrim[T <: STRING | BYTES](value: T) -> T

شرح:

مجموعه مشخصی از BYTES یا CHARS را از انتهای value ارائه شده برش می‌دهد.

اگر to_trim ارائه نشده باشد، کاراکترهای فاصله‌ی انتهایی را حذف می‌کند.

مثال‌ها:

چه زمانی to_trim ارائه نمی‌شود:

ارزش	`rtrim(value)`
"فو"	"فو"
"فو"	"فو"

چه زمانی to_trim ارائه می‌شود:

ارزش	to_trim	`rtrim(value, to_trim)`
"ای بی سی سی"	«سی»	"آب"
«آباکابا»	"با"	"آباک"
"ه"	"ه"	«»

تقسیم

نحو:

split(input: STRING) -> ARRAY<STRING>
split[T <: STRING | BYTES](input: T, delimiter: T) -> ARRAY<T>

شرح:

یک مقدار STRING یا BYTES را با استفاده از یک جداکننده تقسیم می‌کند.

برای STRING جداکننده پیش‌فرض کاما است , جداکننده به عنوان یک رشته واحد در نظر گرفته می‌شود.
برای BYTES ، باید یک جداکننده مشخص کنید.
تقسیم بر روی یک جداکننده خالی، آرایه‌ای از نقاط کد یونیکد برای مقادیر STRING و آرایه‌ای از BYTES برای مقادیر BYTES تولید می‌کند.
تقسیم یک STRING خالی، یک ARRAY با یک STRING خالی برمی‌گرداند.

مثال‌ها:

وقتی delimiter ارائه نشده باشد:

ورودی	`split(input)`
«غذا، بار، غذا»	["غذا"، "بار"، "غذا"]
"فو"	["غذا"]
"،فو،"	["", "غذا", ""]
«»	[""]
ب"C120C2C4"	خطا

وقتی delimiter استفاده می‌شود:

ورودی	جداکننده	`split(input, delimiter)`
"فو بار فو"	« »	["غذا"، "بار"، "غذا"]
"فو بار فو"	«ز»	["غذای بار غذا"]
"ای بی سی"	«»	["الف"، "ب"، "ج"]
ب"C1، C2، C4"	ب""	[ب"C1"، ب"C2"، ب"C4"]
ب "ای بی سی"	ب""	[ب"الف"، ب"ب"، ب"پ"]
"فو"	ب"سی۱"	خطا

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

توابع رشته‌ای

طول بایت

نود جی اس

Web

سویفت

Kotlin

Java

پایتون

جاوا

طول کاراکتر

نود جی اس

Web

سویفت

Kotlin

Java

پایتون

جاوا

شروع_با

نود جی اس

Web

سویفت

Kotlin

Java

پایتون

جاوا

پایان_با

نود جی اس

سویفت

Kotlin

Java

پایتون

جاوا

لایک

نود جی اس

Web

سویفت

Kotlin

Java

پایتون

جاوا

مقادیر منظم (REGEX_CONTAINS)

نود جی اس

Web

سویفت

Kotlin

Java

پایتون

جاوا

تطبیق_عبارت_عبارت_مرتب

نود جی اس

Web

سویفت

Kotlin

Java

پایتون

جاوا

رشته_متصل

نود جی اس

Web

سویفت

Kotlin

Java

پایتون

جاوا

محتویات رشته

نود جی اس

Web

سویفت

Kotlin

Java

پایتون

جاوا

STRING_INDEX_OF

به بالا

نود جی اس

Web

سویفت

Kotlin

Java

توابع رشته