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.