Pular para o conteúdo principal

Funções da biblioteca

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