encodeString

Codifica ou cifra uma string com o algoritmo escolhido.

Sintaxe

string encodeString ( string algoritmo, string dados [, table opcoes, function callback ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
algoritmo	string	—	Nome do algoritmo, sem diferenciar maiúsculas de minúsculas.
dados	string	—	Conteúdo a codificar.
opcoes	table	—	Campos aceitos conforme o algoritmo, na tabela abaixo.
callback	function	—	Se informada, recebe o resultado e encodeString devolve true.

Algoritmos aceitos

Algoritmo	Opções	Resultado
base64	variant = "URL" para o alfabeto seguro para URLs, sem preenchimento	texto em Base64
base32	variant = "HEX" para o alfabeto hexadecimal estendido	texto em Base32
tea	key — obrigatória, não pode ser vazia	bytes cifrados (binário)
aes128	key — exatamente 16 caracteres	dois valores: dados cifrados e o iv gerado
rsa	key — a chave pública	bytes cifrados (binário)

Retorno

O resultado da codificação, ou false em caso de falha: algoritmo desconhecido, chave ausente ou com tamanho errado. O motivo vai para o console de debug.

Cuidado

aes128 devolve dois valores, e o segundo é o iv. Sem ele o decodeString correspondente não tem como funcionar, então guarde os dois juntos.

Note também que encodeString("tea", ...) devolve bytes brutos, enquanto teaEncode devolve Base64. Os dois formatos não são intercambiáveis.

Exemplo

local texto = encodeString("base64", "olá mundo")
local url   = encodeString("base64", "olá mundo", { variant = "URL" })

local cifrado, iv = encodeString("aes128", "dados sensíveis", { key = "1234567890abcdef" })

Veja também

• md5 — Calcula o hash MD5 de uma string.
• sha256 — Calcula o hash SHA-256 de uma string.
• hash — Calcula o hash de uma string com o algoritmo escolhido.
• teaEncode — Cifra uma string com XTEA e devolve o resultado em Base64.
• teaDecode — Desfaz um teaEncode.
• decodeString — Desfaz um encodeString.
• generateKeyPair — Gera um par de chaves RSA.