Para (com
Retornoretorno)
Permite Bloco que permite a criação de funções com retorno.
Parâmetros de Entrada
| Nome | Tipo | Doc |
|---|---|---|
| Parâmetro 1 | VarString | Parâmetro de entrada da função |
| Parâmetro 2 | VarString | Parâmetro de entrada da função |
| Parâmetro n | VarString | Parâmetro de entrada da função |
Retorno
O retorno das funções não têm um tipo específico.
Compatibilidade
Servidor
Cliente
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 é parâmetro é uma entrada específica em uma função utilizada para processamento. Funções podem ou não ter um ou mais parâmetrosmais parâmetros. As As funções mais básicas são aquelas que apenas executam uma rotina, portanto, não recebem parâmetros recebem parâmetros a serem processados.
Exemplo de função sem parâmetros no CronApp - IDE:
Entretanto, existem casos onde o processamento de conteúdo é necessário, tornando obrigatória a passagem de parâmetros para a função.
Sobre o Retorno da Funções
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 e mostra o retorno.
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