Pular para o conteúdo principal

Tutorial rápido (Português) — BASICGOL

1. Hello, world​

#include <basicgol.h>

INICIO
ESCREVAL("Ola, mundo!");
FIM

Compile com cc -std=c11 -I include ola.c build/libbasicgol.a -lm -o ola.

2. Variáveis e aritmética​

INICIO
INTEIRO a = 10;
INTEIRO b = 3;
ESCREVAL("soma = %d", a + b);
FIM

3. Controle de fluxo​

INICIO
INTEIRO i = 0;
PARA (i, 1, 5) {
SE i % 2 == 0 ENTAO
ESCREVAL("%d par", i);
SENAO
ESCREVAL("%d impar", i);
FIM_SE
}
FIM

4. Funções​

FUNCAO INTEIRO dobro(INTEIRO x) {
RETORNE x * 2;
}

INICIO
ESCREVAL("dobro(7) = %d", dobro(7));
FIM

5. Biblioteca padrão​

Inclua os módulos em include/basicgol/ (matemática, texto, console, caracteres, utilidades). Veja docs/09-biblioteca-padrao.md.

Próximos passos​

  • Referência de palavras-chave: docs/02-referencia.md.
  • Exemplos: examples/beginner, examples/intermediate, examples/advanced.
  • Testes: make test.

Perguntas frequentes​

Perguntas frequentes sobre este documento, respondidas a partir do conteúdo versionado e da referência gerada.

Qual é o primeiro programa?​

Um arquivo .c que inclui basicgol.h, abre com INICIO, escreve com ESCREVAL e fecha com FIM.

#include <basicgol.h>

INICIO
ESCREVAL("Ola, mundo!");
FIM

Como declaro variáveis e leio do teclado?​

Declare com o tipo antes do nome. Para números, LEIA usa _Generic; para texto, use TEXTO_FIXO com capacidade e LEIA_TEXTO.

INICIO
INTEIRO idade = 0;
TEXTO_FIXO(nome, 64);

ESCREVA("Nome: ");
LEIA_TEXTO(nome, TAMANHO_DE(nome));
ESCREVA("Idade: ");
LEIA(idade);

ESCREVAL(nome);
ESCREVAL(idade);
FIM

Como escrevo uma função?​

Use FUNCAO tipo nome(parametros) com corpo entre chaves e RETORNE. Procedimentos usam PROCEDIMENTO e, sem parâmetros, escreva (VAZIO).

FUNCAO INTEIRO dobro(INTEIRO x) {
RETORNE x * 2;
}

INICIO
ESCREVAL(dobro(21));
FIM

Como compilo o tutorial?​

O fluxo é o mesmo do restante do projeto; use -I include e ligue a biblioteca.

make
cc -std=c11 -Wall -Wextra -Wformat=2 -I include programa.c \
build/libbasicgol.a -lm -o programa
./programa