توابع نوع

پیش‌نمایش: فایراستور در حالت بومی (با عملیات خط لوله) برای نسخه سازمانی، تابع «شرایط ارائه‌های پیش از GA» در بخش شرایط عمومی خدمات از شرایط خاص خدمات است. شما می‌توانید داده‌های شخصی را برای این ویژگی، همانطور که در ضمیمه پردازش داده‌های ابری ذکر شده است، پردازش کنید، مشروط بر تعهدات و محدودیت‌های شرح داده شده در توافق‌نامه‌ای که تحت آن به Google Cloud دسترسی دارید. ویژگی‌های پیش از GA «به همین صورت موجود» در دسترس هستند و ممکن است پشتیبانی محدودی داشته باشند. برای اطلاعات بیشتر، به توضیحات مرحله راه‌اندازی مراجعه کنید.

توابع نوع

نام	توضیحات
TYPE	نوع مقدار را به صورت STRING برمی‌گرداند.
IS_TYPE	اگر مقدار با نوع مشخص شده مطابقت داشته باشد، true را برمی‌گرداند.

نوع

نحو:

type(input: ANY) -> STRING

شرح:

یک رشته از نوع input را برمی‌گرداند.

اگر مقداری داده نشود، NULL را برمی‌گرداند.

مثال‌ها:

input	type(input)
تهی	"تهی"
درست	"بولی"
۱	"int32"
-3 لیتر	"int64"
۳.۱۴	"شناور64"
‎2024-01-01T00:00:00Z UTC	"برچسب زمانی"
"فو"	"رشته"
ب "غذا"	"بایت"
[1، 2]	"آرایه"
{"الف": 1}	"نقشه"
path("c/d")	«مرجع»
vector([1.0, 2.0])	"بردار"
غایب	تهی

نمونه‌های مشتری

نود جی اس

const result = await db.pipeline()
  .collection("books")
  .select(field("title").notEqual("1984").as("not1984"))
  .execute();
test.firestore.js

Web

const result = await execute(db.pipeline()
  .collection("books")
  .select(field("title").notEqual("1984").as("not1984"))
);
test.firestore.js

سویفت

let result = try await db.pipeline()
  .collection("books")
  .select([Field("title").notEqual("1984").as("not1984")])
  .execute()
PipelineSnippets.swift

Kotlin

val result = db.pipeline()
    .collection("books")
    .select(field("title").notEqual("1984").alias("not1984"))
    .execute()
DocSnippets.kt

Java

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("books")
    .select(field("title").notEqual("1984").alias("not1984"))
    .execute();
DocSnippets.java

پایتون

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("books")
    .select(Field.of("title").not_equal("1984").as_("not1984"))
    .execute()
)
firestore_pipelines.py

جاوا

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("books")
        .select(notEqual(field("title"), "1984").as("not1984"))
        .execute()
        .get();
PipelineSnippets.java

نوع IS

نحو:

is_type(input: ANY, type: STRING) -> BOOLEAN

شرح:

اگر input با type مشخص شده مطابقت داشته باشد، مقدار true و در غیر این صورت false را برمی‌گرداند. اگر input داده نشود، NULL را برمی‌گرداند.

رشته‌های type پشتیبانی‌شده عبارتند از:

• "null"
• "boolean"
• "int32"
• "int64"
• "float64"
• "decimal128"
• "number"
• "timestamp"
• "string"
• "bytes"
• "array"
• "map"
• "reference"
• "vector"
• "geo_point"
• "max_key"
• "min_key"
• "object_id"
• "regex"
• "bson_timestamp"

مثال‌ها:

input	type	is_type(input, type)
تهی	"تهی"	درست
درست	"بولی"	درست
۳.۱۴	"شناور64"	درست
"فو"	"رشته"	درست
ب "غذا"	"رشته"	نادرست
[1، 2]	"آرایه"	درست
{"الف": 1}	"نقشه"	درست
vector([1.0, 2.0])	"بردار"	درست
غایب	"رشته"	تهی
"بار"	«دیگر»	خطا