Debugging-Funktionen

Funktionen debuggen

Name Beschreibung
EXISTS Gibt TRUE zurück, wenn der Wert kein fehlender Wert ist.
IS_ABSENT Gibt TRUE zurück, wenn der Wert ein fehlender Wert ist.
IF_ABSENT Ersetzt den Wert durch einen Ausdruck, wenn er nicht vorhanden ist
IS_ERROR Fängt ab und prüft, ob vom zugrunde liegenden Ausdruck ein Fehler ausgegeben wurde
IF_ERROR Ersetzt den Wert durch einen Ausdruck, wenn ein Fehler aufgetreten ist.

EXISTS

Syntax:

exists(value: ANY) -> BOOLEAN

Beschreibung:

Gibt TRUE zurück, wenn value nicht der fehlende Wert ist.

Beispiele:

value exists(value)
0L TRUE
"foo" TRUE
NULL TRUE
ABSENT FALSE
Node.js

Beispiel:

const results = await db.pipeline()
  .collection("customers")
  .select(exists(Field.of("orders")))
  .execute();

Web

Beispiel:

const result = await execute(db.pipeline()
  .collection("books")
  .select(field("rating").exists().as("hasRating"))
);
test.firestore.js
Swift
let result = try await db.pipeline()
  .collection("books")
  .select([Field("rating").exists().as("hasRating")])
  .execute()
PipelineSnippets.swift

Kotlin

Beispiel:

val result = db.pipeline()
    .collection("books")
    .select(field("rating").exists().alias("hasRating"))
    .execute()
DocSnippets.kt

Java

Beispiel:

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("books")
    .select(field("rating").exists().alias("hasRating"))
    .execute();
DocSnippets.java
Python
from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("books")
    .select(Field.of("rating").exists().as_("hasRating"))
    .execute()
)
firestore_pipelines.py

IS_ABSENT

Syntax:

is_absent(value: ANY) -> BOOLEAN

Beschreibung:

Gibt TRUE zurück, wenn value der fehlende Wert ist, andernfalls FALSE. Fehlende Werte sind Werte, die in der Eingabe fehlen, z. B. ein fehlendes Dokumentfeld.

Beispiele:

value is_absent(value)
0L FALSE
"foo" FALSE
NULL FALSE
ABSENT TRUE

IF_ABSENT

Syntax:

if_absent(value: ANY, replacement: ANY) -> ANY

Beschreibung:

Wenn value ein fehlender Wert ist, wird replacement ausgewertet und zurückgegeben. Andernfalls wird value zurückgegeben.

Beispiele:

value replacement if_absent(value, replacement)
5L 0L 5L
NULL 0L NULL
ABSENT 0L 0L

IS_ERROR

Syntax:

is_error(try: ANY) -> BOOLEAN

Beschreibung:

Gibt TRUE zurück, wenn bei der Auswertung von try ein Fehler ausgegeben wird. Andernfalls wird FALSE zurückgegeben.

IF_ERROR

Syntax:

if_error(try: ANY, catch: ANY) -> ANY

Beschreibung:

Wenn bei der Auswertung von try ein Fehler ausgegeben wird, wird replacement ausgewertet und zurückgegeben. Andernfalls wird der aufgelöste Wert von try zurückgegeben.