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