Mapler

01 · Visão geral

Sobre Mapler

Mapler é uma variante educacional de Portugol: seus comandos descrevem algoritmos em português estruturado e são organizados em blocos legíveis. A referência principal é o manual do projeto Mapler, complementado pelas páginas oficiais de exemplos sobre estrutura, tipos, operações, decisões, laços e módulos.

As regras desta página se referem especificamente a Mapler. Elas não estabelecem uma sintaxe única para as demais variantes da família Portugol.

02 · Organização

Estrutura do algoritmo

Um programa possui uma área variaveis, o bloco executável iniciado por inicio e o encerramento fim. As declarações ficam antes do algoritmo principal; módulos são declarados nessa área e definidos depois do encerramento principal.

variaveis
    nome: cadeia;
    idade: inteiro;
inicio
    escrever "Qual é o seu nome?";
    ler nome;
    escrever "Olá, ", nome;
fim.

O ponto após fim aparece nos exemplos de estrutura do projeto. Dentro dos blocos, os comandos terminam em ponto e vírgula.

03 · Dados

Variáveis, tipos e vetores

Uma declaração usa o nome seguido de dois-pontos e do tipo, dentro da área variaveis. Tipos documentados incluem inteiro, real, logico, caractere e cadeia. Use verdadeiro e falso para valores lógicos; textos ficam entre aspas e caracteres individuais são indicados como literais de caractere.

variaveis
    tentativas: inteiro;
    media: real;
    aprovado: logico;
    inicial: caractere;
    mensagem: cadeia;
    notas: vetor [1..5] de real;
inicio
    tentativas <- 0;
    aprovado <- falso;
    notas[1] <- 8.5;
fim

Os limites do vetor são escritos entre colchetes. O exemplo oficial usa faixa iniciada em 1; escolha índices dentro dos limites declarados.

04 · Cálculos

Atribuição e operadores

A atribuição usa <-. A referência matemática apresenta adição, subtração, multiplicação e divisão com +, -, * e /. Expressões podem combinar variáveis, literais e parênteses; use parênteses quando quiser deixar explícita a ordem do cálculo.

total <- preco * quantidade;
se total >= limite entao
    escrever "Acima do limite";
fim se;

05 · Interação

Entrada e saída

escrever mostra texto ou valores no terminal e aceita vários itens separados por vírgula. ler recebe um valor do teclado e o guarda na variável indicada.

variaveis
    nome: cadeia;
    idade: inteiro;
inicio
    escrever "Nome:";
    ler nome;
    escrever "Idade:";
    ler idade;
    escrever nome, " tem ", idade, " anos.";
fim

O tipo da variável deve corresponder ao dado informado. Mensagens de entrada antes de ler ajudam a deixar claro o que o algoritmo espera.

06 · Decisões

Condições com se e senão

se avalia uma condição; entao inicia o trecho executado quando ela é verdadeira. senao introduz a alternativa opcional. Todo bloco condicional termina em fim se;.

se nota >= 7 entao
    escrever "Aprovado";
senao
    escrever "Continue estudando";
fim se;

Condições aninhadas são permitidas, desde que cada bloco seja fechado antes do bloco externo. Operadores relacionais e lógicos permitem formar expressões compostas.

07 · Repetição

Laços para, enquanto e repita

para percorre um intervalo com variável de controle, início, fim e passo. enquanto testa a condição antes de cada repetição. repita executa o bloco e verifica a condição ao final, garantindo ao menos uma passagem.

variaveis
    i: inteiro;
inicio
    para i de 1 ate 5 passo 1 faca
        escrever i;
    fim para;

    i <- 1;
    enquanto i <= 5 faca
        escrever i;
        i <- i + 1;
    fim enquanto;

    repita
        i <- i - 1;
    ate i = 0;
fim

Os blocos são delimitados pelo nome do comando em fim para; e fim enquanto;. Escolha passo e condição que façam o laço avançar até o término esperado.

08 · Reuso

Módulos

Módulos são blocos nomeados definidos fora do principal e chamados pelo nome. A declaração fica em variaveis com o tipo modulo; os módulos podem acessar variáveis do bloco principal conforme a referência oficial.

variaveis
    dizerOla: modulo;
inicio
    dizerOla;
fim

modulo dizerOla;
    escrever "Rotina reutilizada";
fim modulo;

Essa forma organiza tarefas que seriam repetidas. O material Mapler apresenta módulos sem parâmetros; não confunda esse mecanismo com funções de outras variantes.

09 · Aplicação

Exemplo completo

O exemplo combina declarações, leitura, cálculo e uma decisão. Ele usa apenas estruturas descritas na referência de Mapler.

variaveis
    valor_a: real;
    valor_b: real;
    media: real;
inicio
    escrever "Primeiro valor:";
    ler valor_a;
    escrever "Segundo valor:";
    ler valor_b;
    media <- (valor_a + valor_b) / 2;
    escrever "Média: ", media;
    se media >= 7 entao
        escrever "Resultado suficiente";
    senao
        escrever "Revise o conteúdo";
    fim se;
fim.

10 · Arquivos

Extensão de arquivo no Potoo IDE

O manual do Mapler registra arquivos-fonte de texto com extensão .txt. No Potoo IDE, os arquivos Mapler usam .mapler, escolha inspirada no projeto DesignLiquido/mapler. Esse repositório é citado somente como referência para a extensão adotada; a sintaxe e os recursos documentados aqui vêm do manual e dos exemplos oficiais de Mapler.

11 · Fontes

Referências consultadas

• Manual de uso do Mapler — finalidade, edição, execução e depuração.
• Estrutura do código, tipos e vetores, operações, entrada e saída, condições, laços e módulos.
• DesignLiquido/mapler — inspiração para a extensão .mapler usada pelo Potoo IDE.