在公式運算式中使用字串函數 - AWS IoT SiteWise

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

在公式運算式中使用字串函數

在轉換和量度中，您可以使用下列函數對字串進行操作。如需詳細資訊，請參閱在公式中使用字串。

重要

公式運算式只能輸出雙精度值或字串值。巢狀運算式可以輸出其他資料類型 (例如字串)，但整體公式必須評估為數字或字串。您可以使用 jp 函數將字串轉換為數字。布林值必須是 1 (真) 或 0 (假)。如需詳細資訊，請參閱未定義、無限和溢出值。

函數 描述

len(s)

返回字符串的長度s。

find(s, substring)

返回字符串substring中字符串的索引s。

contains(s, substring)

1如果字符串s包含字符串substring，否則返回0。

upper(s)

返回大寫形式的字符串s。

lower(s)

返回小寫形式的字符串s。

jp(s, json_path)

s使用表達式評估字符JsonPath串json_path並返回結果。

使用此函數可執行下列作業：

  • 從序列化JSON結構中提取值，數組或對象。

  • 將字符串轉換為數字。例如，公式會111以數字的形式jp('111', '$')傳回。

要從JSON結構中提取字符串值並將其作為數字返回，您必須使用多個嵌套jp函數。外部jp函數從JSON結構中提取字符串，並且內部jp函數將字符串轉換為數字。

字串json_path必須包含字串常值。這意味著不json_path能是評估為字符串的表達式。

範例

  • jp('{"status":"active","value":15}', '$.value') 傳回：15

  • jp('{"measurement":{"reading":25,"confidence":0.95}}', '$.measurement.reading') 傳回：25

  • jp('[2,8,23]', '$[2]') 傳回：23

  • jp('{"values":[3,6,7]}', '$.values[1]') 傳回：6

  • jp('111', '$') 傳回：111

  • jp(jp('{"measurement":{"reading":25,"confidence":"0.95"}}', '$.measurement.confidence'), '$') 傳回：0.95

join(s0, s1, s2, s3, ...)

返回帶有分隔符的連接字符串。此函數使用第一個輸入字符串作為分隔符，並將剩餘的輸入字符串連接在一起。這與 Java 中的連接（CharSequence 分隔符， CharSequence... 元素）函數類似。

範例

  • join("-", "aa", "bb", "cc")回報 aa-bb-cc

format(expression: "format") 或 format("format", expression)

返回指定格式的字符串。該函數評估expression為一個值，然後返回指定格式的值。這與 Java 中的格式（字符串格式，對象... args）函數類似。如需有關支援格式的詳細資訊，請參閱 Java 平台中類別格式化程式下的轉換 (標準版 7 API 規格)。

範例

  • format(100+1: "d")返回一個字符串，101。

  • format("The result is %d", 100+1)返回一個字符串，The result is 101。

f'expression'

返回一個連接的字符串。使用此格式化函數，您可以使用簡單的表達式來連接和格式化字符串。這些函數可能包含嵌套表達式。您可以使用 {} (大括號) 內插運算式。這與 Python 中格式化的字符串文字相似。

範例

  • f'abc{1+2: "f"}d' 傳回：abc3.000000d若要評估此範例運算式，請執行下列動作：

    1. format(1+2: "f")返回一個浮點數，3.000000。

    2. join('', "abc", 1+2, 'd')返回一個字符串，abc3.000000d。

    您也可以通過以下方式編寫表達式：join('', "abc", format(1+2: "f"), 'd').