Partilhar via


StringToArray (consulta NoSQL)

APLICA-SE A: NoSQL

Converte uma expressão de cadeia de caracteres em uma matriz.

Sintaxe

StringToArray(<string_expr>)  

Argumentos

Description
string_expr Uma expressão de cadeia de caracteres.

Tipos de devolução

Retorna uma matriz.

Exemplos

O exemplo a seguir ilustra como essa função funciona com várias entradas.

SELECT VALUE {
    parseEmptyArray: StringToArray("[]"),
    parseArray: StringToArray('[ "coats", "gloves", "hats" ]'),
    complexArray: StringToArray('[ { "types": [ "coats", "gloves" ] }, [ "hats" ], 76, false, null ]'),
    nestedArray: StringToArray('[ [ "coats", "gloves" ], [ "hats" ] ]'),
    invalidArray: StringToArray("[ 'coats', 'gloves', 'hats' ]"),
    parseUndefined: StringToArray(undefined),
    parseNull: StringToArray(null)
}
[
  {
    "parseEmptyArray": [],
    "parseArray": [ "coats", "gloves", "hats" ],
    "complexArray": [
      {
        "types": [ "coats", "gloves" ]
      },
      [ "hats" ],
      76,
      false,
      null
    ],
    "nestedArray": [
      [ "coats", "gloves" ],
      [ "hats" ]
    ]
  }
]

Observações

  • Esta função não usa o índice.
  • Se a expressão não puder ser convertida, a função retornará undefined.
  • Os valores de cadeia de caracteres aninhados devem ser escritos com aspas duplas para serem válidos.
  • Aspas simples dentro da matriz não são JSON válidas. Embora aspas simples sejam válidas dentro de uma consulta, elas não são analisadas para matrizes válidas. As cadeias de caracteres dentro da cadeia de caracteres da matriz devem ser escapadas \" ou a citação ao redor deve ser uma única aspas.

Nota

Para obter mais informações sobre o formato JSON, consulte https://json.org.