Pular para o conteúdo principal

Texto

Nome(s)ContratoUsos diretos em testesPortabilidadeFonte
BG_ACRESCENTA_TEXTO ACRESCENTA_TEXTOBG_ACRESCENTA_TEXTO: interface macro da biblioteca. Acrescenta origem ao conteúdo atual de destino, inclusive autoacréscimo.1 arquivo(s)condicionalfonte
BG_COMPARA_TEXTO COMPARA_TEXTOBG_COMPARA_TEXTO: interface macro da biblioteca. Compara conteúdo lexicograficamente e normaliza o resultado para -1, 0 ou 1.1 arquivo(s)condicionalfonte
BG_COPIA_TEXTO COPIA_TEXTOBG_COPIA_TEXTO: interface macro da biblioteca. Copia uma string NUL-terminada para capacidade explícita, sem truncamento silencios5 arquivo(s)condicionalfonte
BG_FORMATA_TEXTO FORMATA_TEXTOBG_FORMATA_TEXTO: interface macro da biblioteca. Formata em buffer limitado com semântica de snprintf e rejeita truncamento.1 arquivo(s)condicionalfonte
BG_JUNTA_TEXTO JUNTA_TEXTOBG_JUNTA_TEXTO: interface macro da biblioteca. Concatena dois textos em um destino limitado, aceitando NULL e sobreposição.4 arquivo(s)condicionalfonte
BG_REAL_PARA_INTEIRO REAL_PARA_INTEIROBG_REAL_PARA_INTEIRO: interface macro da biblioteca. Converte double para int truncando em direção a zero, recusando NaN, infinito1 arquivo(s)condicionalfonte
BG_TAMANHO_TEXTO TAMANHO_TEXTOBG_TAMANHO_TEXTO: interface macro da biblioteca. Conta bytes antes do NUL; NULL é tratado como texto vazio.8 arquivo(s)condicionalfonte
BG_TEXTOS_DIFERENTES TEXTOS_DIFERENTESIndica diferença de conteúdo entre duas strings válidas.2 arquivo(s)condicionalfonte
BG_TEXTOS_IGUAIS TEXTOS_IGUAISCompara conteúdo de duas strings com strcmp.2 arquivo(s)condicionalfonte
BG_TEXTO_PARA_INTEIRO TEXTO_PARA_INTEIROBG_TEXTO_PARA_INTEIRO: interface macro da biblioteca. Converte decimal assinado completo para int, recusando sobra, estouro e pont3 arquivo(s)condicionalfonte
BG_TEXTO_PARA_NATURAL TEXTO_PARA_NATURALBG_TEXTO_PARA_NATURAL: interface macro da biblioteca. Converte decimal não negativo para unsigned sem aceitar sinal negativo.1 arquivo(s)condicionalfonte
BG_TEXTO_PARA_REAL TEXTO_PARA_REALBG_TEXTO_PARA_REAL: interface macro da biblioteca. Converte uma string completa em double usando strtod e preservando errno e saíd3 arquivo(s)condicionalfonte
BG_TEXTO_VAZIO TEXTO_VAZIOBG_TEXTO_VAZIO: interface macro da biblioteca. Indica se o texto é NULL ou tem comprimento zero.1 arquivo(s)condicionalfonte
BG_TRECHO_TEXTO TRECHO_TEXTOBG_TRECHO_TEXTO: interface macro da biblioteca. Copia um intervalo de bytes de uma string para um destino limitado.1 arquivo(s)condicionalfonte

Perguntas frequentes​

Perguntas frequentes sobre a família “Texto”, respondidas com as definições e os usos que o gerador encontrou no repositório.

Quais nomes pertencem a “Texto”?​

Esta família reúne 14 contrato(s): BG_ACRESCENTA_TEXTO, BG_COMPARA_TEXTO, BG_COPIA_TEXTO, BG_FORMATA_TEXTO, BG_JUNTA_TEXTO, BG_REAL_PARA_INTEIRO, BG_TAMANHO_TEXTO, BG_TEXTOS_DIFERENTES, BG_TEXTOS_IGUAIS, BG_TEXTO_PARA_INTEIRO, BG_TEXTO_PARA_NATURAL, BG_TEXTO_PARA_REAL e mais 2. As formas curtas incluem TEXTOS_IGUAIS, TEXTOS_DIFERENTES, TAMANHO_TEXTO, COPIA_TEXTO, JUNTA_TEXTO, ACRESCENTA_TEXTO, TRECHO_TEXTO, COMPARA_TEXTO, TEXTO_VAZIO, FORMATA_TEXTO.

Como colocar um destes nomes no meu programa?​

Inclua o cabeçalho uma única vez e compile em C11. Não é necessário declarar nada à mão: cada nome é macro do cabeçalho.

Trecho de BG_ACRESCENTA_TEXTO:

#include <basicgol.h>

TEXTO_FIXO(saudacao, 32) = "ola ";
ACRESCENTA_TEXTO(saudacao, TAMANHO_DE(saudacao), "mundo");

Qual é a diferença entre a forma curta e a forma BG_*?​

São o mesmo nome: a forma curta é um alias textual da canônica e ambas são reunidas na mesma página de referência. Os testes de qualquer alias contam como evidência da macro.

BG_ACRESCENTA_TEXTO /* forma canônica */
ACRESCENTA_TEXTO /* alias equivalente */

Estes nomes funcionam fora de C11?​

Não. O cabeçalho recusa C99/C89 com mensagem explícita e usa _Generic para selecionar formatos e divisões. Compiladores e sistemas operacionais continuam sendo os do alvo; consulte a matriz de compatibilidade.

Como uma macro desta família aparece em uso real?​

Trecho de tests/casos/09_tipos_expr/t11_texto_seguro/programa.c:22:

// --- acréscimo ao que já existe (o strncat seguro)
ESCREVAL(COPIA_TEXTO(buf, TAMANHO_VETOR(buf), "ab"));
ESCREVAL(ACRESCENTA_TEXTO(buf, TAMANHO_VETOR(buf), "cd"));
ESCREVA_TEXTO(buf); ESCREVA_LINHA();
ESCREVAL(ACRESCENTA_TEXTO(buf, TAMANHO_VETOR(buf), "efgh"));