الدوال العامة

الدوال العامة

الاسم الوصف
CURRENT_DOCUMENT تعرض هذه السمة المستند الذي تتم معالجته حاليًا في مسار العرض.
CONCAT تدمج هذه الدالة قيمتَين أو أكثر من النوع نفسه.
LENGTH تحسب هذه الدالة طول String أو Bytes أو Array أو Vector أو Map.
REVERSE تعكس هذه السمة قيمة String أو Bytes أو Array.

CURRENT_DOCUMENT

البنية:

current_document() -> MAP

الوصف:

يتم تقييمها إلى خريطة تحتوي على جميع الحقول المحدّدة في النطاق الحالي. يكون ذلك مفيدًا عند دمج أو تجميع مستندات متعددة معًا أو عند الرغبة في فحص أسماء الحقول في المستند بشكل ديناميكي.

على سبيل المثال، للحصول على قائمة بالمستندات المجمّعة حسب حقل معيّن، اتّبِع الخطوات التالية:

Node.js

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

CONCAT

البنية:

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

الوصف:

تدمج هذه الدالة قيمتَين أو أكثر من النوع نفسه.

أمثلة:

values concat(values)
"abc" و"def" "abcdef"
[1, 2], [3, 4] [1, 2, 3, 4]
b"abc", b"def" b"abcdef"
"abc", [1,2,3], "ghi" خطأ
[1,2,3] خطأ
"abc", null قيمة فارغة
Node.js
concat(constant("Author ID: "), field("authorId"));
test.firestore.js

Web

concat(constant("Author ID: "), field("authorId"));
test.firestore.js
Swift
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
Python
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)
"hello" 5
[1, 2, 3, 4] 4
b"abcde" 5
قيمة فارغة قيمة فارغة
1 خطأ

REVERSE

البنية:

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

الوصف:

تعكس هذه الدالة قيمة String أو Bytes أو Array.

أمثلة:

القيمة reverse(value)
"hello" "olleh"
[1, 2, 3] [3, 2, 1]
b"abc" b"cba"
23 خطأ
قيمة فارغة قيمة فارغة