Para (com retorno) / To (with return)
Permite a criação de funções com retorno.
Figura 1 - Bloco Para (com retorno)
Compatibilidade
Bloco cliente e servidor: procedures_defreturn()
Retorno
O retorno das funções não possui um tipo específico. As funções podem retornar valores resultantes de um processo executado internamente, permitindo sua utilização para diversos fins. O retorno é realizado por meio do comando "retorna", que também finaliza a execução da função.
Características do bloco
O bloco Para (com retorno) permite a adição de parâmetros de entrada na função. Para isso, clique no ícone de configuração do bloco e arraste os blocos "nome da entrada" para a área correspondente. Para mais informações de configurações dos parâmetros de entrada de uma função, consulte o tópico "Parâmetros da função" da documentação Variável.
Após adicionar os parâmetros à função, eles ficarão disponíveis na categoria "Variáveis" do menu lateral do blockly. Para mais detalhes, consulte o tópico "Parâmetros" da documentação Bloco de programação.
Além disso, o bloco, disponível na categoria “Funções”, que representa a função, passa a exibir a quantidade de entradas/parâmetros definida durante sua configuração. Para mais detalhes, consulte o tópico "Funções" da documentação Bloco de programação.
Figura 2 - Adicionando parâmetros de entrada ao bloco
Também é possível passar uma entidade (objeto) como parâmetro de entrada de uma função. No entanto, enquanto os tipos simples (número, texto, booleano) são passados por valor, as entidades são passadas por referência.
Para associar uma entidade a um parâmetro, adicione um parâmetro de entrada, clique no ícone de engrenagem (seta da Figura 2.1) e selecione a entidade no campo "Tipo da variável" (destaque 1 da Figura 2.1). Dessa forma, o parâmetro será passado como referência na função.
Figura 2.1 - Adicionando parâmetros de entrada do tipo entidade
Parâmetros
Retorno
Valor de retorno da função, que pode ser utilizado em outras funções.
Posição: 1
Inglês: Return
Tipo: Objeto / Object
Exemplo: variável com um valor de retorno
Exemplo
A função com retorno da imagem abaixo realiza a soma de dois números e armazena o valor da soma na variável "resultado". Em seguida, a variável "resultado" é adicionada ao retorno da função. Dessa forma, o valor de retorno da função pode ser utilizado em outras funções (Figura 3.1).
Figura 3 - Exemplo de uso do bloco Para (com retorno)
A função da imagem a seguir imprime, no console do depurador, o valor de retorno da função da Figura 3.
Figura 3.1 - Função que utiliza o valor de retorno da função da Figura 3
Nesta página