Compartilhar via


STRINGTONUMBER – Linguagem de consulta no Cosmos DB (no Azure e no Fabric)

A STRINGTONUMBER função converte uma expressão de cadeia de caracteres em um número.

A STRINGTONUMBER função converte uma expressão de cadeia de caracteres em um número no Azure Cosmos DB para NoSQL.

Sintaxe

STRINGTONUMBER(<string_expr>)

Arguments

Description
string_expr Uma expressão de cadeia de caracteres.

Tipos de retorno

Retorna um valor numérico.

Exemplos

Esta seção contém exemplos de como usar este constructo de linguagem de consulta.

Converter cadeia de caracteres em número

Neste exemplo, a STRINGTONUMBER função é usada para converter várias expressões de cadeia de caracteres em números.

SELECT VALUE {
  parseIntegerString: STRINGTONUMBER("100"),
  parseDecimalString: STRINGTONUMBER("3.14"),
  parseWithWhitespace: STRINGTONUMBER("   60   "),
  parseScientific: STRINGTONUMBER("-1.79769e+308"),
  parseInvalid: STRINGTONUMBER("Hello"),
  parseUndefined: STRINGTONUMBER(undefined),
  parseNull: STRINGTONUMBER(null),
  parseNaN: STRINGTONUMBER(NaN),
  parseInfinity: STRINGTONUMBER(Infinity)
}
[
  {
    "parseIntegerString": 100,
    "parseDecimalString": 3.14,
    "parseWithWhitespace": 60,
    "parseScientific": -1.79769e+308
  }
]

Observações

  • Essa função não utiliza o índice.
  • As expressões de cadeia de caracteres são analisadas como uma expressão de número JSON.
  • Os números em JSON devem ser um inteiro ou um ponto flutuante.
  • Se a expressão não puder ser convertida, a função retornará undefined.