Texto e conversões
| Função | Visibilidade | Resumo | Arquivos de teste | Fonte |
|---|---|---|---|---|
bg_acrescenta_texto | pública | Acrescenta origem ao conteúdo atual de destino, inclusive autoacréscimo. | 2 | fonte |
bg_compara_texto | pública | Compara conteúdo lexicograficamente e normaliza o resultado para -1, 0 ou 1. | 3 | fonte |
bg_copia_texto | pública | Copia uma string NUL-terminada para capacidade explícita, sem truncamento silencioso. | 4 | fonte |
bg_formata_texto | pública | Formata em buffer limitado com semântica de snprintf e rejeita truncamento. | 2 | fonte |
bg_junta_texto | pública | Concatena dois textos em um destino limitado, aceitando NULL e sobreposição. | 2 | fonte |
bg_numero_para_inteiro | pública | Converte double para int truncando em direção a zero, recusando NaN, infinito e faixa não representável. | 2 | fonte |
bg_pula_espaco_ascii | interna (static) | Avança um ponteiro sobre os seis caracteres whitespace ASCII usados pelas conversões. | 0 | fonte |
bg_pula_espaco_ascii_final | interna (static) | Valida a cauda de uma conversão numérica avançando sobre whitespace ASCII restante. | 0 | fonte |
bg_tamanho_texto | pública | Conta bytes antes do NUL; NULL é tratado como texto vazio. | 4 | fonte |
bg_texto_para_inteiro | pública | Converte decimal assinado completo para int, recusando sobra, estouro e ponteiros inválidos. | 2 | fonte |
bg_texto_para_natural | pública | Converte decimal não negativo para unsigned sem aceitar sinal negativo. | 2 | fonte |
bg_texto_para_real | pública | Converte uma string completa em double usando strtod e preservando errno e saída em falha. | 3 | fonte |
bg_texto_vazio | pública | Indica se o texto é NULL ou tem comprimento zero. | 2 | fonte |
bg_trecho_texto | pública | Copia um intervalo de bytes de uma string para um destino limitado. | 2 | fonte |
Perguntas frequentes
Perguntas frequentes sobre o módulo “Texto e conversões”, com assinaturas, receita de build e limites de erro extraídos do fonte.
O que o módulo “Texto e conversões” oferece?
14 função(ões): bg_acrescenta_texto, bg_compara_texto, bg_copia_texto, bg_formata_texto, bg_junta_texto, bg_numero_para_inteiro, bg_pula_espaco_ascii, bg_pula_espaco_ascii_final, bg_tamanho_texto, bg_texto_para_inteiro, bg_texto_para_natural, bg_texto_para_real, bg_texto_vazio, bg_trecho_texto. Todas têm protótipo público no cabeçalho do módulo e implementação em src/biblioteca/.
Como compilar e ligar um programa que usa este módulo?
Inclua basicgol.h e o cabeçalho do módulo e ligue build/libbasicgol.a. No caminho GCC/Clang, funções de libm também pedem -lm.
Assinatura real de bg_acrescenta_texto:
#include <basicgol.h>
#include "include/basicgol/texto.h"
cc -std=c11 -Wall -Wextra -Wformat=2 -I include programa.c \
build/libbasicgol.a -o programa
bool bg_acrescenta_texto(char *destino, size_t capacidade, const char *origem)
As funções devolvem erro ou encerram o programa?
Depende do contrato: operações recuperáveis devolvem LOGICO e preservam a saída em falha; violações fatais documentadas (por exemplo divisor zero em DIVIDE e passo zero em PARA_PASSO) chamam ERRO e terminam com status 1. Cada página de função mostra Retorno e Contrato e armadilhas.
Como conferir este módulo antes de integrar?
A biblioteca tem suíte unitária própria, além dos casos dourados da linguagem.
make test-biblioteca
make test
make test-portabilidade
Como este módulo aparece em teste real?
Trecho de tests/portabilidade/fronteira.c:72:
char trecho[4];
EXIGE(bg_acrescenta_texto(dst, 6, "cde") == true); /* 5 + NUL */
EXIGE(strcmp(dst, "abcde") == 0);
EXIGE(bg_acrescenta_texto(dst, 6, "f") == false);