توابع عمومی، توابع عمومی

توابع عمومی

نام توضیحات
CURRENT_DOCUMENT سندی را که در حال حاضر در خط لوله پردازش می‌شود، برمی‌گرداند.
CONCAT دو یا چند مقدار از یک نوع را به هم متصل می‌کند.
LENGTH طول یک String ، Bytes ، Array ، Vector یا Map را محاسبه می‌کند.
REVERSE یک String ، Bytes یا Array را معکوس می‌کند.

سند فعلی

نحو:

current_document() -> MAP

شرح:

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

برای مثال، برای دریافت لیستی از اسناد گروه‌بندی شده بر اساس یک فیلد:

نود جی اس 

const cities = await db.pipeline()
  .collection("/restaurants")
  .aggregate({
    groups: [ field("location.state").as("state") ],
    accumulators: [ arrayAgg(currentDocument().as("restaurants")) ]
   })
  .execute();

کانکت

نحو:

concat[T <: STRING | BYTES | ARRAY](values:T ...) -> T

شرح:

دو یا چند مقدار از یک نوع را به هم متصل می‌کند.

مثال‌ها:

ارزش‌ها concat(values)
«ای‌بی‌سی»، «دفاع» "الف ب دف"
[1، 2]، [3، 4] [1، 2، 3، 4]
ب"الفبا"، ب"تعریف" ب"الف ب"تعریف
"الفبا"، [۱،۲،۳]، "غی" خطا
[1،2،3] خطا
"abc"، تهی تهی
نود جی اس 
concat(constant("Author ID: "), field("authorId"));
test.firestore.js

Web 

concat(constant("Author ID: "), field("authorId"));
test.firestore.js
سویفت 
let displayString = Constant("Author ID: ").concat([Field("authorId")])
PipelineSnippets.swift

Kotlin 

val displayString = constant("Author ID: ").concat(field("authorId"))

DocSnippets.kt

Java 

Expression displayString = constant("Author ID: ").concat(field("authorId"));
DocSnippets.java
پایتون 
Constant.of("Author ID: ").concat(Field.of("authorId"))
firestore_pipelines.py

طول

نحو: 

length[T <: STRING | BYTES | ARRAY | VECTOR | MAP](value: T) -> INT64

شرح:

طول یک مقدار String ، Bytes ، Array ، Vector یا Map را محاسبه می‌کند.

مثال‌ها:

ارزش length(value)
«سلام» ۵
[1، 2، 3، 4] ۴
ب"الف ب" ۵
تهی تهی
۱ خطا

معکوس

نحو: 

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

شرح:

مقدار یک String ، Bytes یا Array را معکوس می‌کند.

مثال‌ها:

ارزش reverse(value)
«سلام» "الله"
[1، 2، 3] [3، 2، 1]
ب"الفبا" ب"سی بی ای"
۲۳ خطا
تهی تهی