Funções de string - AWS IoT SiteWise

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Funções de string

Em transformações e métricas, você pode usar as seguintes funções para operar em cadeias de caracteres. Para obter mais informações, consulte Usando cadeias de caracteres em fórmulas.

Importante

As expressões de fórmula só podem gerar valores duplos ou em sequência de caracteres. Expressões aninhadas podem gerar outros tipos de dados, como cadeias de caracteres, mas a fórmula como um todo deve ser avaliada como um número ou sequência de caracteres. Você pode usar a função jp para converter uma string em um número. O valor booleano deve ser 1 (verdadeiro) ou 0 (falso). Para obter mais informações, consulte Valores indefinidos, infinitos e excedidos.

Função Descrição

len(s)

Retorna o tamanho da strings.

find(s, substring)

Retorna o índice da stringsubstring na strings.

contains(s, substring)

Retorna1 se a strings contiver a stringsubstring, caso contrário0.

upper(s)

Retorna a strings em letras maiúsculas.

lower(s)

Retorna a strings em minúsculas.

jp(s, json_path)

Avalia a strings com a JsonPathexpressãojson_path e retorna o resultado.

Use esta função para fazer o seguinte:

  • Extraia um valor, matriz ou objeto de uma estrutura JSON serializada.

  • Converta uma string em um número. Por exemplo, a fórmulajp('111', '$') retorna111 como um número.

Para extrair um valor de string de uma estrutura JSON e retorná-lo como um número, você deve usar váriasjp funções aninhadas. Ajp função externa extrai a string da estrutura JSON e ajp função interna converte a string em um número.

A stringjson_path deve conter uma string literal. Isso significa que nãojson_path pode ser uma expressão avaliada como uma string.

exemplo Exemplos
  • O jp('{"status":"active","value":15}', '$.value') Retorna 15.

  • O jp('{"measurement":{"reading":25,"confidence":0.95}}', '$.measurement.reading') Retorna 25.

  • O jp('[2,8,23]', '$[2]') Retorna 23.

  • O jp('{"values":[3,6,7]}', '$.values[1]') Retorna 6.

  • O jp('111', '$') Retorna 111.

  • O jp(jp('{"measurement":{"reading":25,"confidence":"0.95"}}', '$.measurement.confidence'), '$') Retorna 0.95.

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

Retorna uma string concatenada com um delimitador. Essa função usa a primeira string de entrada como delimitador e une as sequências de entrada restantes. Isso se comporta de forma semelhante à função join (CharSequence delimitador, CharSequence... elementos) em Java.

exemplo Exemplos
  • join("-", "aa", "bb", "cc")devoluçõesaa-bb-cc

format(expression: "format") ou format("format", expression)

Retorna uma string no formato especificado. Essa função éexpression avaliada como um valor e, em seguida, retorna o valor no formato especificado. Isso se comporta de forma semelhante à função format (String format, Object... args) em Java. Para obter mais informações sobre formatos suportados, consulte Conversões em formatador de classe na plataforma Java, especificação da API Standard Edition 7.

exemplo Exemplos
  • format(100+1: "d")retorna uma string,101.

  • format("The result is %d", 100+1)retorna uma string,The result is 101.

f'expression'

Retorna uma string concatenada. Com essa função formatada, você pode usar uma expressão simples para concatenar e formatar cadeias de caracteres. Essas funções podem conter expressões aninhadas. Você pode usar{} (chaves) para interpolar expressões. Isso se comporta de forma semelhante aos literais de string formatados em Python.

exemplo Exemplos
  • O f'abc{1+2: "f"}d' Retorna abc3.000000d. Para avaliar esse exemplo de expressão, faça como mostrado abaixo:

    1. format(1+2: "f")retorna um número de ponto flutuante,3.000000.

    2. join('', "abc", 1+2, 'd')retorna uma string,abc3.000000d.

    Você também pode escrever a expressão da seguinte forma:join('', "abc", format(1+2: "f"), 'd').