Generic Functions Reference

Generic Functions Reference

פונקציות גנריות

שם	תיאור
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

תיאור:

הפונקציה משרשרת שני ערכים או יותר מאותו סוג.

לדוגמה:

ערכים	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	null

Node.js

concat(constant("Author ID: "), field("authorId"));
test.firestore.js

אינטרנט

concat(constant("Author ID: "), field("authorId"));
test.firestore.js

Swift

let displayString = Constant("Author ID: ").concat([Field("authorId")])
PipelineSnippets.swift

‫Kotlin
Android

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

‫Java
Android

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.

לדוגמה:

value	length(value)
"hello"	5
[1, 2, 3, 4]	4
b"abcde"	5
null	null
1	שגיאה

היפוך

תחביר:

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

תיאור:

הפונקציה הופכת ערך מסוג String,‏ Bytes או Array.

לדוגמה:

value	reverse(value)
"hello"	‪"olleh"
‫[1, 2, 3]	‫[3, 2, 1]
b"abc"	b"cba"
23	שגיאה
null	null

המאמרים הבאים

• סקירה כללית של שאילתות צינורות