Pular para o conteúdo principal

Texto e conversões

FunçãoVisibilidadeResumoArquivos de testeFonte
bg_acrescenta_textopúblicaAcrescenta origem ao conteúdo atual de destino, inclusive autoacréscimo.2fonte
bg_compara_textopúblicaCompara conteúdo lexicograficamente e normaliza o resultado para -1, 0 ou 1.3fonte
bg_copia_textopúblicaCopia uma string NUL-terminada para capacidade explícita, sem truncamento silencioso.4fonte
bg_formata_textopúblicaFormata em buffer limitado com semântica de snprintf e rejeita truncamento.2fonte
bg_junta_textopúblicaConcatena dois textos em um destino limitado, aceitando NULL e sobreposição.2fonte
bg_numero_para_inteiropúblicaConverte double para int truncando em direção a zero, recusando NaN, infinito e faixa não representável.2fonte
bg_pula_espaco_asciiinterna (static)Avança um ponteiro sobre os seis caracteres whitespace ASCII usados pelas conversões.0fonte
bg_pula_espaco_ascii_finalinterna (static)Valida a cauda de uma conversão numérica avançando sobre whitespace ASCII restante.0fonte
bg_tamanho_textopúblicaConta bytes antes do NUL; NULL é tratado como texto vazio.4fonte
bg_texto_para_inteiropúblicaConverte decimal assinado completo para int, recusando sobra, estouro e ponteiros inválidos.2fonte
bg_texto_para_naturalpúblicaConverte decimal não negativo para unsigned sem aceitar sinal negativo.2fonte
bg_texto_para_realpúblicaConverte uma string completa em double usando strtod e preservando errno e saída em falha.3fonte
bg_texto_vaziopúblicaIndica se o texto é NULL ou tem comprimento zero.2fonte
bg_trecho_textopúblicaCopia um intervalo de bytes de uma string para um destino limitado.2fonte

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);