cast.as_string
cast.as_string(int_or_bytes_or_bool, optional_default_string)
Descrição
A função cast.as_string
transforma um valor INT
, BYTES
ou BOOL
na respetiva representação de string. Pode fornecer um argumento default_string
opcional para processar casos em que a conversão falha. Se omitir o argumento default_string
ou se a entrada for uma sequência de bytes UTF-8
ou BASE64
inválida, a função devolve uma string vazia.
Tipos de dados de parâmetros
INT|BYTES|BOOL
, STRING
Tipo devolvido
STRING
Exemplos de código
Conversão de número inteiro para string
A função converte o número inteiro 123
na string "123"
.
cast.as_string(123) = "123"
Conversão de número de ponto flutuante em string
A função converte o número de vírgula flutuante 2.25
na string "2.25"
.
cast.as_string(2.25) = "2.25"
Conversão de bytes em string
A função converte o binário não processado b'01
na string "\x01"
.
cast.as_string(b'01, "") = "\x01"
Conversão de Booleano para string
A função converte o valor booleano true
na string "true"
.
cast.as_string(true, "") = "true"
Conversão falhada (predefinição para a string fornecida opcionalmente)
A função usa a string "casting error"
por predefinição quando o valor fornecido é inválido.
cast.as_string(9223372036854775808, "casting error") = "casting error"