การแก้ไขข้อบกพร่องของฟังก์ชัน

การแก้ไขข้อบกพร่องของฟังก์ชัน

ชื่อ	คำอธิบาย
EXISTS	แสดงผล TRUE หากค่าไม่ใช่ค่าที่ไม่มี
IS_ABSENT	แสดงผล TRUE หากค่าเป็นค่าที่ไม่มี
IF_ABSENT	แทนที่ค่าด้วยนิพจน์หากค่านั้นไม่มี
IS_ERROR	ตรวจจับและตรวจสอบว่านิพจน์พื้นฐานแสดงข้อผิดพลาดหรือไม่
IF_ERROR	แทนที่ค่าด้วยนิพจน์หากค่านั้นแสดงข้อผิดพลาด
ERROR	ยุติการประเมินและแสดงข้อผิดพลาดพร้อมข้อความที่ระบุ

EXISTS

ไวยากรณ์:

exists(value: ANY) -> BOOLEAN

คำอธิบาย:

แสดงผล TRUE หาก value ไม่ใช่ค่าที่ไม่มี

ตัวอย่าง:

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

Node.js

const result = await db.pipeline()
  .collection("books")
  .select(field("rating").exists().as("hasRating"))
  .execute();
test.firestore.js

Web

ตัวอย่าง:

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

ตัวอย่าง:

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

Java

ตัวอย่าง:

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

Java

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("books")
        .select(exists(field("rating")).as("hasRating"))
        .execute()
        .get();
PipelineSnippets.java

IS_ABSENT

ไวยากรณ์:

is_absent(value: ANY) -> BOOLEAN

คำอธิบาย:

แสดงผล TRUE หาก value เป็นค่าที่ไม่มี และ FALSE ในกรณีอื่นๆ ค่าที่ไม่มีคือค่าที่ขาดหายไปจากอินพุต เช่น ช่องเอกสารที่ขาดหายไป

ตัวอย่าง:

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

IF_ABSENT

ไวยากรณ์:

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

คำอธิบาย:

หาก value เป็นค่าที่ไม่มี ฟังก์ชันจะประเมินและแสดงผล replacement ไม่เช่นนั้นจะแสดงผล value

ตัวอย่าง:

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

IS_ERROR

ไวยากรณ์:

is_error(try: ANY) -> BOOLEAN

คำอธิบาย:

แสดงผล TRUE หากมีการแสดงข้อผิดพลาดระหว่างการประเมิน try และแสดงผล FALSE ในกรณีอื่นๆ

IF_ERROR

ไวยากรณ์:

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

คำอธิบาย:

หากมีการแสดงข้อผิดพลาดระหว่างการประเมิน try ฟังก์ชันจะประเมินและแสดงผล replacement ไม่เช่นนั้นจะแสดงผลค่าที่ได้จาก try

ERROR

ไวยากรณ์:

error(message: STRING) -> ANY

คำอธิบาย:

การประเมินฟังก์ชัน error จะทำให้การประเมินไปป์ไลน์สิ้นสุดลงด้วยข้อผิดพลาด message ที่ระบุจะรวมอยู่ในข้อผิดพลาด

ตัวอย่าง:

cond	res	switch_on(cond, res, error("no condition matched"))
TRUE	1L	1L
FALSE	1L	ERROR ("no condition matched")