Funkcje debugowania
| Nazwa | Opis |
EXISTS
|
Zwraca TRUE, jeśli wartość nie jest wartością pustą.
|
IS_ABSENT
|
Zwraca TRUE, jeśli wartość jest nieobecna.
|
IF_ABSENT
|
Zastępuje wartość wyrażeniem, jeśli jest ona nieobecna. |
IS_ERROR
|
Wyłapuje i sprawdza, czy wyrażenie bazowe zgłosiło błąd. |
IF_ERROR
|
Zastępuje wartość wyrażeniem, jeśli wystąpił błąd. |
ISTNIEJE
Składnia:
exists(value: ANY) -> BOOLEAN
Opis:
Zwraca TRUE, jeśli value nie jest wartością pustą.
Przykłady:
value |
exists(value) |
|---|---|
| 0L | TRUE |
| „foo” | TRUE |
NULL |
TRUE |
ABSENT |
FALSE |
Przykład:
const results = await db.pipeline() .collection("customers") .select(exists(Field.of("orders"))) .execute();
Web
Przykład:
const result = await execute(db.pipeline() .collection("books") .select(field("rating").exists().as("hasRating")) );
Swift
let result = try await db.pipeline() .collection("books") .select([Field("rating").exists().as("hasRating")]) .execute()
Kotlin
Przykład:
val result = db.pipeline() .collection("books") .select(field("rating").exists().alias("hasRating")) .execute()
Java
Przykład:
Task<Pipeline.Snapshot> result = db.pipeline() .collection("books") .select(field("rating").exists().alias("hasRating")) .execute();
Python
from google.cloud.firestore_v1.pipeline_expressions import Field result = ( client.pipeline() .collection("books") .select(Field.of("rating").exists().as_("hasRating")) .execute() )
IS_ABSENT
Składnia:
is_absent(value: ANY) -> BOOLEAN
Opis:
Zwraca TRUE, jeśli value jest wartością nieobecną, a w przeciwnym razie zwraca FALSE. Wartości nieobecne to wartości, których brakuje w danych wejściowych, np. brakujące pole dokumentu.
Przykłady:
value |
is_absent(value) |
|---|---|
| 0L | FALSE |
| „foo” | FALSE |
NULL |
FALSE |
ABSENT |
TRUE |
IF_ABSENT
Składnia:
if_absent(value: ANY, replacement: ANY) -> ANY
Opis:
Jeśli value jest wartością nieobecną, funkcja ocenia i zwraca wartość replacement. W przeciwnym razie zwraca wartość value.
Przykłady:
value |
replacement |
if_absent(value, replacement) |
|---|---|---|
| 5L | 0L | 5L |
NULL |
0L | NULL |
ABSENT |
0L | 0L |
IS_ERROR
Składnia:
is_error(try: ANY) -> BOOLEAN
Opis:
Zwraca TRUE, jeśli podczas oceny elementu try wystąpi błąd. W przeciwnym razie zwraca wartość FALSE.
IF_ERROR
Składnia:
if_error(try: ANY, catch: ANY) -> ANY
Opis:
Jeśli podczas oceny elementu try wystąpi błąd, funkcja ocenia i zwraca element replacement. W przeciwnym razie zwraca rozwiązaną wartość elementu try.