===== Function =====

==== Formato ====
**function** functionname ( //lista de variáveis// )\\
//código//\\
**end function**

**function** functionname$ ( //lista de variáveis// )\\
//código//\\
**end function**

==== Descrição ====

Cria uma função que irá receber valores de entrada, processá-los e devolver um valor numérico ou alfanumérico de saída. Todas as variáveis ​utilizadas para processamento na função serão locais para essa função, isto é não efectam variáveis com o mesmo nome fora da função.

Em BASIC-256 a função devolve o valor de saída após a instrução RETURN ou após por chegar ao fim da função. Se não houver código na função esta devolve zero (0) no caso das variaveis numéricas ou ("") no caso das variaveis alfanuméricas.

Variáveis de entrada (numéricas ou alfanuméricas) são, separadas por vírgula. Arrays e variáveis podem ser passados por referência usando [[Ref|Ref]].
 
Funções devem ser definidas na parte inferior do seu programa, e não pode ser definido dentro de outro bloco subrotina, ou estrutura de controle ([[ifthen|If/Then]], [[dountil|Do/Until]]).
==== Exemplo ====

<code>
print double$("Olá")
print triple(3)
end

function double$(a$)
   double$ = a$ + a$
end function

function triple(b)
   triple = b * 3
   return
   triple = 9999	# este código não é executado pois existe um RETURN antes
end function
</code>
Mostrará\\
<code>
OláOlá
9
</code>
==== Ver também ====
[[Global|Global]], [[Ref|Ref]], [[Return|Return]], [[Subroutine|Subroutine]]

==== Introduzido ==== 
0.9.9.1