Funções da biblioteca
- Extensões opcionais — 3 função(ões)
- Caracteres ASCII — 4 função(ões)
- Console e diagnóstico — 10 função(ões)
- filesystem — 7 função(ões)
- Matemática — 27 função(ões)
- Texto e conversões — 14 função(ões)
- Utilidades e sorteio — 4 função(ões)
Perguntas frequentes
Perguntas frequentes sobre as funções C da biblioteca padrão.
Preciso ligar a biblioteca para usar essas funções?
Sim. As funções bg_* são compiladas em build/libbasicgol.a; o cabeçalho declara os protótipos. Sem o archive (ou os fontes de src/biblioteca/) a ligação falha com undefined reference.
make biblioteca
cc -std=c11 -I include programa.c build/libbasicgol.a -lm -o programa
Como essas funções reportam erro?
A maioria devolve LOGICO: false significa entrada inválida, truncamento ou falha de E/S, e o destino não é alterado (strings ficam vazias quando há espaço para o NUL). Operações fatais são exceções documentadas, como divisor zero em DIVIDE.
Qual é a diferença entre a função bg_* e a macro em português?
A macro é a interface didática; a função é o código compilado. Quando os nomes coincidem semanticamente, a página da macro mostra a função associada e ambas as páginas apontam para o mesmo contrato.
As funções são thread-safe?
Texto, caractere, console e matemática não mantêm estado global. A exceção é o gerador pseudoaleatório de utilidades, que compartilha estado de processo e não é criptográfico nem thread-safe.
Como os módulos são testados?
Por uma suíte unitária própria, além dos casos dourados da linguagem.
make test-biblioteca
make test