O módulo json é um módulo do Starlark de funções relacionadas ao JSON.
Membros
decode
unknown json.decode(x)
A função de decodificação aceita um parâmetro de posição, uma string JSON.
Ela retorna o valor do Starlark indicado pela string.
- "null", "true" e "false" são analisados como None, True e False.
- Os números são analisados como int ou como pontos flutuantes se tiverem um ponto decimal ou expoente. Embora o JSON não tenha sintaxe para valores não finitos, valores muito grandes podem ser decodificados como infinito.
- um objeto JSON é analisado como um novo dict Starlark descongelado. As chaves precisam ser strings exclusivas.
- Uma matriz JSON é analisada como uma nova lista Starlark descongelada.
.
A decodificação falhará se x não for uma codificação JSON válida.
Parâmetros
| Parâmetro |
Descrição |
x
|
obrigatório
|
encode
string json.encode(x)
A função de codificação aceita um argumento posicional obrigatório, que é convertido em JSON pelos casos:
- None, True e False são convertidos em "null", "true" e "false", respectivamente.
- Um int, não importa o tamanho, é codificado como um número inteiro decimal. Alguns decodificadores podem não ser capazes de decodificar números inteiros muito grandes.
- Um ponto flutuante é codificado usando um ponto decimal, um expoente ou ambos, mesmo que seu valor numérico seja um número inteiro. É um erro codificar um valor de ponto flutuante não finito.
- Um valor de string é codificado como um literal de string JSON que indica o valor. Cada alternativo não pareado é substituído por U+FFFD.
- Um dict é codificado como um objeto JSON, em ordem de chave. Se alguma chave não for uma string, será um erro.
- Uma lista ou tupla é codificada como uma matriz JSON.
- Um valor semelhante a struct é codificado como um objeto JSON, na ordem do nome do campo.
.
Um tipo definido pelo aplicativo pode definir a própria codificação JSON.
A codificação de qualquer outro valor resulta em um erro.
Parâmetros
| Parâmetro |
Descrição |
x
|
obrigatório
|
encode_indent
string json.encode_indent(x, *, prefix='', indent='\t')
A função encode_indent é equivalente a
json.indent(json.encode(x), ...). Consulte
indent para conferir a descrição dos parâmetros de formatação.
Parâmetros
| Parâmetro |
Descrição |
x
|
obrigatório
|
prefix
|
padrão = ''
|
indent
|
padrão = '\t'
|
indent
string json.indent(s, *, prefix='', indent='\t')
A função de recuo retorna a forma recuada de uma string codificada em JSON válida.
Cada elemento da matriz ou campo de objeto aparece em uma nova linha, começando com a string de prefixo seguida por uma ou mais cópias da string de recuo, de acordo com a profundidade de aninhamento.
A função aceita um parâmetro posicional obrigatório, a string JSON,
e dois parâmetros de string opcionais somente de palavra-chave, prefix e indent,
que especificam um prefixo de cada nova linha e a unidade de recuo.
Se a entrada não for válida, a função pode falhar ou retornar uma saída inválida.
Parâmetros
| Parâmetro |
Descrição |
s
|
obrigatório
|
prefix
|
padrão = ''
|
indent
|
padrão = '\t'
|
