# Rotinas, Parâmetros e Funções

A sintaxe básica para declaração de uma rotina é a seguinte:

<mark style="color:blue;">`Rotina para que se`</mark><mark style="color:green;">`<nome da rotina>`</mark><mark style="color:red;">`:`</mark>

O nome da rotina começa após o **"se"**.&#x20;

Parâmetros são indicados pelos artigos indefinidos:&#x20;

* **um**
* **uns**
* **uma**
* **umas**

Exemplos:

<mark style="color:blue;">`Rotina para que se`</mark> <mark style="color:green;">`adicione`</mark> <mark style="color:purple;">`uma`</mark>` ``cor`` `<mark style="color:red;">`e`</mark> <mark style="color:purple;">`um`</mark>` ``rótulo`` `<mark style="color:red;">`para`</mark>` `<mark style="color:purple;">`um`</mark>` ``menu:`

**Nome da rotina:** adicione

**Parâmetros:** cor, rótulo, menu

**Preposições e conjunções:** e, para.

<mark style="color:blue;">`Rotina para que se`</mark> <mark style="color:green;">`crie`</mark>` `<mark style="color:purple;">`uma`</mark>` ``imagem`` `<mark style="color:red;">`usando`</mark>` `<mark style="color:purple;">`uma`</mark>` ``URL:`

**Nome da rotina:** crie

**Parâmetros:** imagem, URL

**Preposições e conjunções:** usando

{% hint style="info" %}
As preposições e conjunções embora não façam parte do nome da rotina, devem ser invocadas de forma similar ao declarado no cabeçalho da rotina.&#x20;
{% endhint %}

A 1ª rotina acima pode ser chamada de forma similar ao exemplo abaixo:

```
Adicione a cor preta e "Abrir" para o menu.
Adicione a cor vermelha e "Fechar" ao menu.
```

A 2ª rotina, por exemplo poderia ser chamada das seguintes formas:

```
Crie a imagem usando a URL.
Crie a imagem dada a URL.
Crie a imagem com a URL.
Crie a imagem desde a URL.
```

{% hint style="info" %}
Perceba que a linguagem suporta:

**Contrações em geral\***

* à -> para a
* ao -> para o
* deste -> de este
* destes -> de estes
* desta -> de estas
* destas -> de estas
* desta -> de esta
* na -> em a
* nas -> em as
* no -> em o
* nos -> em os
* num -> em um
* nuns -> em uns
* numa -> em uma
* numas -> em umas
* pelo -> por o
* pelos -> por os
* pela -> por a
* pelas -> por as

**Sinônimos** (para as preposições).&#x20;

* com / contendo / dado / desde / usando
* em / para / por
  {% endhint %}

Para um melhor entendimento da linguagem iremos converter a função Javascript abaixo para Português Puro:

{% code lineNumbers="true" %}

```javascript
function FazAlgumaCoisa(numero) {
  if(number < 0){
    return;
    }
  let contador = numero * 2;
  while (true) {
    contador ++;
    if (contador >= 10) {
      break;
    }
  }
}
```

{% endcode %}

**Dados da função**

**Nome:** FazAlgumaCoisa.

**Parâmetros:** numero.

**Variáveis locais:** contador.

**Número de linhas:** **12\***&#x20;

*\*sendo que destas 12 linhas, 4 são inteiramente desperdiçadas com colchetes e espaços em branco*

*<mark style="color:blue;">A rotina acima ficaria assim:</mark>*

> **Para que se** *faça alguma coisa* com <mark style="color:purple;">**um**</mark> número:&#x20;
>
> &#x20; Se <mark style="color:purple;">**o**</mark> número for menor do que 0, *<mark style="color:blue;">**retorne**</mark>*.&#x20;
>
> &#x20; Atribua <mark style="color:purple;">**o**</mark> número vezes 2 para <mark style="color:red;">**um**</mark> contador.&#x20;
>
> &#x20; *<mark style="color:blue;">**Itere**</mark>*.&#x20;
>
> &#x20;   Adicione 1 para <mark style="color:red;">**o**</mark> contador.&#x20;
>
> &#x20;   Se <mark style="color:red;">**o**</mark> contador for maior do que 10, *<mark style="color:blue;">**pare**</mark>*.&#x20;
>
> &#x20; *<mark style="color:blue;">**Reitere**</mark>*.

**Dados da rotina**

**Nome:** Faça alguma coisa

**Parâmetros:** número

**Variáveis locais:** contador.

**Número de linhas: 7**

{% hint style="info" %}
Ao invés da keyword ***function*** nós utilizamos ***para que se** (o termo "Rotina" é opcional).*
{% endhint %}

Note que o parâmetro <mark style="color:purple;">**"número"**</mark> bem como a variável local <mark style="color:red;">**"contador"**</mark> foram referenciados com um artigo definido após serem introduzidas no código pela 1ª vez com um artigo indefinido.

## Funções de retorno booleano

A linguagem trabalha com o conceito de "funções deliberativas".

A sintaxe básica para declaração de uma função booleana é a seguinte:

<mark style="color:blue;">`Função para que se determine se`</mark><mark style="color:green;">`<expressão a ser avaliada>`</mark><mark style="color:red;">`:`</mark>

O nome da função começa após o **"Função para que se determine se"**.

Exemplo:

> **Função para que se determine se** <mark style="color:purple;">**um**</mark> número *<mark style="color:red;">**é**</mark>* negativo:&#x20;
>
> &#x20; Se <mark style="color:purple;">**o**</mark> número for menor do que 0, <mark style="color:green;">**diga sim.**</mark>&#x20;
>
> &#x20; <mark style="color:blue;">\ Caso contrário</mark>
>
> &#x20; <mark style="color:red;">**Diga não.**</mark>

<mark style="color:green;">**"Diga sim"**</mark> equivale a um *<mark style="color:green;">"return true"</mark>* e <mark style="color:red;">**"Diga não"**</mark> é o equivalente de *<mark style="color:red;">"return false"</mark>*.

Toda função booleana precisa terminar com um "Diga sim" ou "Diga não".

{% hint style="success" %}
O cabeçalho de funções booleanas devem ser iniciado da seguinte forma "**Função para que se determine se"**
{% endhint %}

{% hint style="warning" %}
As funções deliberativas devem, obrigatoriamente ser invocadas a partir de expressões condicionais.&#x20;
{% endhint %}

{% hint style="danger" %}
As expressões condicionais somente podem ser incluídas dentro do escopo do corpo de uma rotina.
{% endhint %}

Para utilizar uma função de retorno booleano em uma rotina, basta usar o restante do cabeçalho da função (ou seja, o nome da função sem o trecho "**Função para que se determine").**

Exemplo:

**`Rotina para que se escreva o fatorial de um número:`**

&#x20; ***`Se o número`\*\*\*\*` `**<mark style="color:red;">**`for`**</mark>**` `\*\*\*\*`negativo, retorne.`***

&#x20; ***`Se o número for 1, atribua 1 ao número.`***

***`[...]`***&#x20;

{% hint style="warning" %}
Os verbos ser/estar (e suas respectivas conjugações) são tratados como sinônimos pelo compilador.
{% endhint %}

## Regras gerais para nomes de rotinas e funções

* O nome da rotina começa após o *"para que se"* (ou após o *"para que se determine se"* no caso de funções deliberativas).
* Artigos indefinidos indicam um novo parâmetro. Exemplos:
  * *um número,*
  * *uns vértices,*
  * *uma string,*
  * *umas formas*
* Parênteses podem ser utilizados para "escapar" strings, parâmetros ou indicar rotinas de um mesmo grupo. Exemplo:
  * *Rotina para que se execute um evento (clique - botão direito):*&#x20;
  * *Rotina para que se execute um evento (clique - botão esquerdo):*&#x20;
  * *Rotina para que se execute um evento (clique duplo):*&#x20;
  * *Rotina para que se execute um evento (atualização de tela):*&#x20;
* Preposições e artigos definidos são permitidos nos nomes das rotinas (porém não exercem nenhuma função especial além de tornar o nome da função mais inteligível). Exemplos:
  * *Rotina para que se execute **o** programa:*
  * *Rotina para que se ajuste **a** caixa de diálogo:*
  * *Rotina para que se adicione um botão **para a** caixa de diálogo **usando** uma string:*

{% hint style="info" %}
Perceba nas rotinas logo acima que os artigos definidos **não** indicam um parâmetro.&#x20;
{% endhint %}

## Cálculos de campos em tempo de execução


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://portugues-puro.gitbook.io/documentacao/rotinas-parametros-e-funcoes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.