Pular para o conteúdo principal

Começar com BASICGOL

BASICGOL é uma camada de macros sobre C11. Um programa é um arquivo .c que inclui basicgol.h; não há máquina virtual nem interpretador no caminho de execução. O transpilador basicgolc é opcional e só existe para o açúcar sintático que o pré-processador não consegue produzir.

Esta página leva do zero ao primeiro programa compilado, e explica o que fazer quando o compilador reclama.

1. O que você precisa ter instalado​

RequisitoPara quêObservação
Compilador C11compilar o programa e a bibliotecaGCC, Clang e MinGW-w64 foram exercitados; MSVC é apenas avaliado
makeconstruir build/basicgolc e build/libbasicgol.ao Makefile pressupõe ambiente Unix-like
arcriar o archive estático da bibliotecao alvo biblioteca usa ar rcs
Bashrunners de teste e exemplosno Windows, Git Bash/MSYS2; não é CMD/PowerShell
Python 3.10+apenas para o gerador deste sitenão é necessário para compilar BASICGOL

Se você só quer usar a linguagem, um compilador C11 e make bastam. Node.js, Python e npm entram apenas na construção da documentação.

2. Compilar a biblioteca e o transpilador​

make

Isso produz build/basicgolc e build/libbasicgol.a. Alvos úteis do mesmo Makefile:

make biblioteca # somente build/libbasicgol.a
make test # suíte da linguagem + biblioteca
make test-biblioteca # somente os módulos da biblioteca
make exemplos # compila os exemplos versionados
make ajuda # lista todos os alvos

No Windows, o projeto usa os workflows MSYS2/MinGW e MSVC documentados no repositório. O Makefile não é um projeto Visual Studio.

3. Escrever um programa​

#include <basicgol.h>

FUNCAO REAL media(REAL a, REAL b) {
RETORNE (a + b) / 2.0;
}

INICIO
REAL n1 = 0.0;
REAL n2 = 0.0;

ESCREVA("Nota 1: ");
LEIA(n1);
ESCREVA("Nota 2: ");
LEIA(n2);

SE media(n1, n2) >= 7.0 ENTAO
ESCREVAL("Aprovado");
SENAO
ESCREVAL("Ainda nao aprovado");
FIM_SE
FIM

O arquivo tem extensão .c de propósito (decisão D-14): ele é C válido depois da expansão das macros, e a maioria das ferramentas de C o trata corretamente.

O que cada bloco faz​

TrechoExpansão conceitualPerfil
INICIOint main(void) {N (macros)
FIM}N
FUNCAO REAL media(...)REAL media(...) — FUNCAO expande para nadaN
SE ... ENTAO / SENAO / FIM_SEif (...) { / } else { / }N
ESCREVAL(x)escrita de um valor com quebra de linha, formato escolhido por _GenericN
LEIA(x)leitura formatada de um escalar; o formato vem do tipo do destinoN

4. Compilar diretamente — caminho M0​

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

M0 usa apenas as macros do cabeçalho. Construtores como SE ... ENTAO, ENQUANTO ... FACA e PARA (i, a, b) são redutíveis no pré-processador, sem etapa extra.

A ordem dos argumentos importa em toolchains Unix: primeiro a fonte, depois o archive build/libbasicgol.a, e -lm por último. Se a plataforma já incorpora libm, -lm pode ser omitido; ele é obrigatório no GCC/Clang do Linux quando há matemática.

5. Usar a sintaxe açucarada — caminho M1​

INICIO
INTEIRO i = 0;
PARA i DE 1 ATE 3 FACA
ESCREVAL(i);
FIM_PARA
FIM
build/basicgolc programa.c -o programa.gerado.c
cc -std=c11 -I include programa.gerado.c build/libbasicgol.a -lm -o programa
./programa

M1 traduz blocos e açúcar sintático; o compilador C continua responsável por tipos, semântica, otimização e ligação. O C gerado também recebe o cabeçalho BASICGOL, então as macros continuam disponíveis.

M0 ou M1? Como decidir​

SituaçãoCaminhoPor quê
Só usa construtores que são macrosM0menos uma ferramenta no build
Usa PARA i DE … ATE … FACA ou PASSOM1exige reordenar tokens
Quer diagnóstico de bloco (FIM_SE órfão etc.)M1o pré-processador não enxerga estrutura
Quer o build mais simples possívelM0um único comando de compilação
Precisa de binário idêntico em qualquer alvoqualquer umo resultado final é C compilado pelo mesmo compilador

Os dois caminhos usam a mesma fonte e a mesma biblioteca. Não existe “dialeto M0” e “dialeto M1”: existe um subconjunto que dispensa o transpilador.

6. Ler dados sem deixar lixo no fluxo​

LEIA é leitura formatada e pode deixar o newline no stdin. Para texto use LEIA_TEXTO com capacidade explícita; para uma linha convertida em número use LEIA_INTEIRO/LEIA_REAL.

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

ESCREVA("Nome: ");
SE LEIA_TEXTO(nome, TAMANHO_DE(nome)) ENTAO
ESCREVA("Idade: ");
SE LEIA_INTEIRO(idade) ENTAO
ESCREVAL(nome);
ESCREVAL(idade);
SENAO
ESCREVAL("idade invalida");
FIM_SE
SENAO
ESCREVAL("nome invalido");
FIM_SE
FIM

As três funções devolvem LOGICO; false significa que a conversão não foi completa e o destino numérico não foi alterado.

7. Diagnósticos comuns de build​

MensagemCausa provávelCorreção
BASICGOL exige C11faltou -std=c11 ou o compilador está em C99adicione -std=c11
undefined reference to bg_*biblioteca não ligada ou fora de ordemcoloque build/libbasicgol.a depois da fonte
undefined reference to pow/sqrtfalta -lmadicione -lm ao final da linha
erro de _Generic em LEIAdestino LOGICO, TEXTO ou TEXTO_FIXOuse LEIA_TEXTO/LEIA_INTEIRO
FIM_SE sem SE (M1)bloco desbalanceadoconfira a estrutura ou compile em M0 para comparar
aviso de TAMANHO_VETOR(ponteiro)ponteiro não mede vetorpasse o vetor real ou o tamanho

8. Conferir antes de integrar​

make test
make test-biblioteca
make test-portabilidade

Perguntas frequentes​

Preciso instalar algo além de um compilador C?​

Para compilar e executar, não. make constrói a biblioteca e o transpilador, mas você também pode compilar os fontes de src/biblioteca/*.c diretamente junto do seu programa. Python e Node só entram na geração do site.

cc -std=c11 -Wall -Wextra -I include programa.c \
src/biblioteca/*.c -lm -o programa

Por que o arquivo tem extensão .c e não .bg?​

Porque a fonte é C válido depois da expansão das macros e o projeto decidiu (D-14) não inventar uma extensão própria. Isso permite usar qualquer editor, linter, formatador e sistema de build de C sem configuração especial.

Meu programa não compila e a mensagem aponta para basicgol.h. O que fazer?​

Leia a primeira mensagem, não a última. Erros em macro costumam aparecer no ponto de uso. Compile com -std=c11 e confirme que incluiu include/. Se a mensagem for de _Generic, provavelmente LEIA recebeu um tipo sem formato.

cc -std=c11 -Wall -Wextra -Wformat=2 -I include programa.c \
build/libbasicgol.a -lm -o programa 2>&1 | head -n 20

make falhou no Windows. O Makefile não funciona?​

O Makefile pressupõe ambiente Unix-like (Bash, ar, mktemp). No Windows, use MSYS2/MinGW ou o workflow MSVC; não há suporte a nmake no repositório.

Posso misturar C normal e BASICGOL no mesmo arquivo?​

Sim, essa é a proposta. #include, struct, ponteiros e funções da biblioteca padrão continuam disponíveis. As palavras-chave em português são macros, então evite usá-las como nomes de variável.

#include <basicgol.h>
#include <string.h>

INICIO
TEXTO_FIXO(s, 16);
COPIA_TEXTO(s, TAMANHO_DE(s), "abc");
ESCREVAL((INTEIRO) strlen(s));
FIM

Como sei se meu código precisa do M1?​

Se ele compila e roda sem basicgolc, você está em M0 e não precisa do transpilador. Se usa PARA i DE … FACA, o pré-processador não consegue reordenar os tokens e a compilação direta falha — é o sinal de que o caminho é M1.

Onde ficam os testes que provam o comportamento que estou usando?​

Cada página de símbolo tem uma seção Como este símbolo aparece nos testes, com arquivo, linha e trecho. Comece por Testes e siga os links de linha.