Compartilhar via


StringToArray (consulta NoSQL)

APLICA-SE A: NoSQL

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

Sintaxe

StringToArray(<string_expr>)  

Argumentos

Descrição
string_expr Uma expressão de cadeia de caracteres.

Tipos de retorno

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" ]
    ]
  }
]

Comentários

  • Essa função não usa o índice.
  • Se a expressão não puder ser convertida, a função retornará undefined.
  • Valores de cadeia de caracteres aninhados devem ser gravados com aspas duplas para serem válidos.
  • Aspas simples dentro da matriz não são válidas em JSON. Mesmo que as aspas simples sejam válidas em uma consulta, elas não são analisadas em matrizes válidas. As cadeias de caracteres da matriz devem ser de escape \" ou a aspa ao redor deve ser simples.

Observação

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