Texto
| Nome(s) | Contrato | Usos diretos em testes | Portabilidade | Fonte |
|---|---|---|---|---|
BG_ACRESCENTA_TEXTO ACRESCENTA_TEXTO | BG_ACRESCENTA_TEXTO: interface macro da biblioteca. Acrescenta origem ao conteúdo atual de destino, inclusive autoacréscimo. | 1 arquivo(s) | condicional | fonte |
BG_COMPARA_TEXTO COMPARA_TEXTO | BG_COMPARA_TEXTO: interface macro da biblioteca. Compara conteúdo lexicograficamente e normaliza o resultado para -1, 0 ou 1. | 1 arquivo(s) | condicional | fonte |
BG_COPIA_TEXTO COPIA_TEXTO | BG_COPIA_TEXTO: interface macro da biblioteca. Copia uma string NUL-terminada para capacidade explícita, sem truncamento silencios | 5 arquivo(s) | condicional | fonte |
BG_FORMATA_TEXTO FORMATA_TEXTO | BG_FORMATA_TEXTO: interface macro da biblioteca. Formata em buffer limitado com semântica de snprintf e rejeita truncamento. | 1 arquivo(s) | condicional | fonte |
BG_JUNTA_TEXTO JUNTA_TEXTO | BG_JUNTA_TEXTO: interface macro da biblioteca. Concatena dois textos em um destino limitado, aceitando NULL e sobreposição. | 4 arquivo(s) | condicional | fonte |
BG_REAL_PARA_INTEIRO REAL_PARA_INTEIRO | BG_REAL_PARA_INTEIRO: interface macro da biblioteca. Converte double para int truncando em direção a zero, recusando NaN, infinito | 1 arquivo(s) | condicional | fonte |
BG_TAMANHO_TEXTO TAMANHO_TEXTO | BG_TAMANHO_TEXTO: interface macro da biblioteca. Conta bytes antes do NUL; NULL é tratado como texto vazio. | 8 arquivo(s) | condicional | fonte |
BG_TEXTOS_DIFERENTES TEXTOS_DIFERENTES | Indica diferença de conteúdo entre duas strings válidas. | 2 arquivo(s) | condicional | fonte |
BG_TEXTOS_IGUAIS TEXTOS_IGUAIS | Compara conteúdo de duas strings com strcmp. | 2 arquivo(s) | condicional | fonte |
BG_TEXTO_PARA_INTEIRO TEXTO_PARA_INTEIRO | BG_TEXTO_PARA_INTEIRO: interface macro da biblioteca. Converte decimal assinado completo para int, recusando sobra, estouro e pont | 3 arquivo(s) | condicional | fonte |
BG_TEXTO_PARA_NATURAL TEXTO_PARA_NATURAL | BG_TEXTO_PARA_NATURAL: interface macro da biblioteca. Converte decimal não negativo para unsigned sem aceitar sinal negativo. | 1 arquivo(s) | condicional | fonte |
BG_TEXTO_PARA_REAL TEXTO_PARA_REAL | BG_TEXTO_PARA_REAL: interface macro da biblioteca. Converte uma string completa em double usando strtod e preservando errno e saíd | 3 arquivo(s) | condicional | fonte |
BG_TEXTO_VAZIO TEXTO_VAZIO | BG_TEXTO_VAZIO: interface macro da biblioteca. Indica se o texto é NULL ou tem comprimento zero. | 1 arquivo(s) | condicional | fonte |
BG_TRECHO_TEXTO TRECHO_TEXTO | BG_TRECHO_TEXTO: interface macro da biblioteca. Copia um intervalo de bytes de uma string para um destino limitado. | 1 arquivo(s) | condicional | fonte |
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"));