Para (com retorno)
Permite a criação de funções com retorno
Função Base64 para texto
Função para remover a codificação base64. Ela converte valores previamente codificados com a função "Para Base64" em seu valor original.
Parâmetros de Entrada
| Nome | Tipo | Doc | |
|---|---|---|---|
| Parâmetro 1 | String | Parâmetro de entrada da função | String codificada em Base64 |
Retorno
| Parâmetro 2 | String | Parâmetro de entrada da função |
| Parâmetro n | String | Parâmetro de entrada da função |
Retorno
O retorno das funções não têm um tipo específico.String original antes da codificação com Base64
Compatibilidade
Servidor
Cliente
Exemplo 1
Dado o conteúdo codificado VGV4dG8gZGUgRXhlbXBsbyAx o sistema deverá apresentar a mensagem "Texto de Exemplo 1".
O bloco de programação abaixo é uma função que realiza a soma de dois números. Esta função recebe dois parâmetros de entrada num e num2, que são processados e atribuídos a variável resultado, sendo retornada ao final do bloco de execução através do comando retorna.
Figura 1 - Somando valores
Sobre Funções
Uma função é um fragmento de código que realiza uma tarefa específica. Uma vez criada uma função, pode-se fazer sua chamada quando necessário, evitando assim a tarefa de reescrita da mesma.
Retorno
Funções podem retornar valores de um processo executado internamente. Esse valor pode ser utilizado posteriormente para os mais diferentes fins. O retorno é dado pelo comando retorna, que finaliza a função.
Figura 2.1 - Função com retorno
Parâmetros e Funções
Um parâmetro é uma entrada específica em uma função utilizada para processamento. Funções podem ou não ter um ou mais parâmetros. As funções mais básicas são aquelas que apenas executam uma rotina, portanto, não recebem parâmetros a serem processados. Caso haja necessidade de adição de parâmetro numa função, é possível adicioná-lo clicando no ícone de configuração, arrastando o bloco nome da entrada para dentro da função entrada e editando seu nome através do botão com formato de engrenagem.
Figura 2.2 - Adicionando parâmetros
Após criado, o bloco que representa a função passar a apresentar a quantidade de entradas/parâmetros definida durante a criação da função. O bloco deve ser usado em conjunto com um bloco que receba entrada, pois contém retorno.
Figura 2.3 - Bloco da função com os parâmetros de entrada
Parâmetros e entidades
Também é possível passar uma entidade (objeto) por parâmetro da função, porém, quando utilizamos entidades, o parâmetro será passado por referência, já os tipos simples (número, texto, booleano) é passado por valor.
Para associar uma entidade a um parâmetro, adicione um parâmetro de entrada, clique no ícone da engrenagem e selecione a entidade no campo Tipo da variável. Esse parâmetro será passado como referência, ou seja, o valor da variável é uma referência para um objeto.
Figura 2.3 - Adicionando parâmetro com entidade
Sobre a Base64
Base64 é um método para codificação de dados para transferência na Internet. É utilizado frequentemente para transmitir dados binários por meios de transmissões que lidam apenas com texto, como por exemplo para enviar arquivos anexos por email.
Exemplo de decodificação:
- String em Base64: aGVsbG8gd29ybGQK
- Texto original: hello world