BG_TAMANHO_TEXTO · TAMANHO_TEXTO
Gerada por tools/gerar_documentacao.py. Definição: include/basicgol.h:221.
BG_TAMANHO_TEXTO: interface macro da biblioteca. Conta bytes antes do NUL; NULL é tratado como texto vazio.
Tipo: macro com argumentos · Módulo/categoria: Texto.
Nomes equivalentes: TAMANHO_TEXTO. Os testes de qualquer um desses nomes são reunidos nesta página.
Assinatura e expansão
#define BG_TAMANHO_TEXTO(s) bg_tamanho_texto(s)
Parâmetros formais: s.
Corpo da macro:
bg_tamanho_texto(s)
Como funciona
Retorna zero para NULL e strlen nos demais casos. Não conta codepoints Unicode nem caracteres de terminal.
Exemplo de uso
ESCREVAL(TAMANHO_TEXTO("abc")); /* 3 */
Comentário do fonte
--- texto ---
Nomes internos referenciados: bg_tamanho_texto.
Como este símbolo aparece nos testes
17 ocorrência(s) em 8 arquivo(s) de teste. Os links apontam para linhas exatas; os trechos mostram o contexto local. Uma menção não prova que todos os ramos foi executado.
tests/casos/02_basico/b05_caractere/programa.c
Contexto: b05_caractere. Linhas: 14. Tipo de evidência: código; via TAMANHO_TEXTO.
Linhas 12–16 · abrir contexto
ESCREVAL((INTEIRO) 'A');
ESCREVAL((INTEIRO) quebra);
ESCREVAL(TAMANHO_TEXTO(nome));
ESCREVAL(nome[0]);
ESCREVAL(nome[7]);
tests/casos/04_estruturas/e03_texto_buffer/programa.c
Contexto: e03_texto_buffer. Linhas: 13. Tipo de evidência: código; via TAMANHO_TEXTO.
Linhas 11–14 · abrir contexto
JUNTA_TEXTO(saudacao, (INTEIRO) sizeof saudacao, "ola, ", nome);
ESCREVAL(saudacao);
ESCREVAL(TAMANHO_TEXTO(saudacao));
FIM
tests/casos/05_entrada_saida/i09_texto_truncamento/programa.c
Contexto: i09_texto_truncamento. Linhas: 12. Tipo de evidência: código; via TAMANHO_TEXTO.
Linhas 10–14 · abrir contexto
ok = COPIA_TEXTO(a, (INTEIRO) sizeof a, "abcdef");
ESCREVAL(ok); // 0
ESCREVAL(TAMANHO_TEXTO(a)); // 0 (destino vazio)
ok = COPIA_TEXTO(a, (INTEIRO) sizeof a, "abc");
tests/casos/05_entrada_saida/i11_tamanho_texto_acentos/programa.c
Contexto: i11_tamanho_texto_acentos. Linhas: 5, 6, 7, 8. Tipo de evidência: código; via TAMANHO_TEXTO.
Linhas 3–9 · abrir contexto
INICIO
ESCREVAL(TAMANHO_TEXTO("abc")); // 3
ESCREVAL(TAMANHO_TEXTO("")); // 0
ESCREVAL(TAMANHO_TEXTO("ação")); // 6 bytes: a + ç(2) + ã(2) + o
ESCREVAL(TAMANHO_TEXTO(NULL)); // 0 (robusto)
FIM
tests/casos/08_aplicacao/app_acervo/principal.c
Contexto: app_acervo. Linhas: 10. Tipo de evidência: código; via TAMANHO_TEXTO.
Linhas 8–12 · abrir contexto
NATURAL i = 0;
INTEIRO valor = -1;
ENQUANTO i < TAMANHO_TEXTO(s) FACA
SE s[i] >= '0' E s[i] <= '9' ENTAO
SE valor < 0 ENTAO
tests/casos/09_tipos_expr/t11_texto_seguro/programa.c
Contexto: t11_texto_seguro. Linhas: 14, 20, 27, 35, 42, 58, 67. Tipo de evidência: código; via TAMANHO_TEXTO.
Linhas 12–16 · abrir contexto
ESCREVA_TEXTO(buf); ESCREVA_LINHA();
ESCREVAL(COPIA_TEXTO(buf, TAMANHO_VETOR(buf), "12345678"));
ESCREVAL(TAMANHO_TEXTO(buf)); // 0: falha limpa o destino
// --- junção de dois textos
Linhas 18–22 · abrir contexto
ESCREVA_TEXTO(buf); ESCREVA_LINHA();
ESCREVAL(JUNTA_TEXTO(buf, TAMANHO_VETOR(buf), "abcd", "efgh"));
ESCREVAL(TAMANHO_TEXTO(buf)); // 0
// --- acréscimo ao que já existe (o strncat seguro)
Linhas 25–29 · abrir contexto
ESCREVA_TEXTO(buf); ESCREVA_LINHA();
ESCREVAL(ACRESCENTA_TEXTO(buf, TAMANHO_VETOR(buf), "efgh"));
ESCREVAL(TAMANHO_TEXTO(buf)); // 0: 6 caracteres não caberiam
// --- trecho: quantidade limitada ao que existe, início além do fim = vazio
Linhas 33–37 · abrir contexto
ESCREVA_TEXTO(buf); ESCREVA_LINHA();
ESCREVAL(TRECHO_TEXTO(buf, TAMANHO_VETOR(buf), "abcdef", 99, 1));
ESCREVAL(TAMANHO_TEXTO(buf));
ESCREVAL(TRECHO_TEXTO(buf, TAMANHO_VETOR(buf), NULL, 0, 1));
Linhas 40–44 · abrir contexto
ESCREVA_TEXTO(buf); ESCREVA_LINHA();
ESCREVAL(FORMATA_TEXTO(dest, TAMANHO_VETOR(dest), "%s", "longo"));
ESCREVAL(TAMANHO_TEXTO(dest));
TEXTO formato = "<%d>";
ESCREVAL(FORMATA_TEXTO(dest, TAMANHO_VETOR(dest), formato, 7));
Linhas 56–60 · abrir contexto
// --- origem NULL nunca é desreferenciada
ESCREVAL(COPIA_TEXTO(buf, TAMANHO_VETOR(buf), NULL));
ESCREVAL(TAMANHO_TEXTO(buf));
// --- origem e destino podem ser o mesmo buffer (as cópias usam memmove)
1 outros blocos de contexto: use os links de linha e o JSON de inventário.
tests/portabilidade/cabecalhos_tu1.c
Contexto: cabecalhos_tu1.c. Linhas: 35. Tipo de evidência: código; via TAMANHO_TEXTO.
Linhas 33–37 · abrir contexto
return 0;
}
if (bg_tamanho_texto("abc") != 3u || TAMANHO_TEXTO("abcd") != 4u) {
return 0;
}
tests/portabilidade/cabecalhos_tu3.c
Contexto: cabecalhos_tu3.c. Linhas: 37. Tipo de evidência: código; via BG_TAMANHO_TEXTO.
Linhas 35–38 · abrir contexto
BG_FIM_SE
return BG_TAMANHO_TEXTO("tu3") == 3u ? total : 0; /* 7 */
}
Evidência indireta
Estes símbolos chamam/encaminham para este nome. As referências deles ajudam a rastrear o caminho, mas não substituem um teste específico deste símbolo.
TAMANHO_TEXTO→ tests/casos/02_basico/b05_caractere/programa.c, tests/casos/04_estruturas/e03_texto_buffer/programa.c, tests/casos/05_entrada_saida/i09_texto_truncamento/programa.c, tests/casos/05_entrada_saida/i11_tamanho_texto_acentos/programa.c, tests/casos/08_aplicacao/app_acervo/principal.c …
Compiladores, padrão C e sistema operacional
Condições que envolvem a definição:
-
defined(BASICGOL_H)(fonte) -
O resultado é em bytes da codificação de execução; não há decodificação UTF-8 dependente de OS.
A matriz histórica distingue executado, compilado, avaliado e não testado. Consulte a matriz, os compiladores e os logs atuais dos workflows antes de chamar um alvo de suportado.
Checklist de integração
- Compile com C11: o cabeçalho seleciona formatos e divisões com
_Generic, e C99/C89 são recusados com mensagem explícita. - A forma curta
TAMANHO_TEXTOe a forma canônicaBG_TAMANHO_TEXTOsão a mesma macro; escolha uma por arquivo para não misturar estilos. - Rode
make test(oumake test-bibliotecapara a biblioteca) antes de integrar.
make
cc -std=c11 -Wall -Wextra -Wformat=2 -I include programa.c \
build/libbasicgol.a -lm -o programa
Perguntas frequentes
Perguntas reunidas a partir da definição, do contrato editorial e dos testes de BG_TAMANHO_TEXTO. As respostas repetem apenas o que o repositório mostra; quando não há evidência, isso é dito.
Em uma frase, o que BG_TAMANHO_TEXTO faz?
BG_TAMANHO_TEXTO: interface macro da biblioteca. Conta bytes antes do NUL; NULL é tratado como texto vazio.
Para que exatamente BG_TAMANHO_TEXTO expande?
O pré-processador substitui BG_TAMANHO_TEXTO pelo texto abaixo, sem criar função nem avaliar argumentos por conta própria.
Parâmetros formais: s.
bg_tamanho_texto(s)
Como usar BG_TAMANHO_TEXTO em um programa?
Exemplo editorial mantido em tools/documentacao/contratos.json e conferido contra a assinatura real:
ESCREVAL(TAMANHO_TEXTO("abc")); /* 3 */
Onde BG_TAMANHO_TEXTO é exercitado nos testes?
Há 17 ocorrência(s) em 8 arquivo(s): tests/casos/02_basico/b05_caractere/programa.c, tests/casos/04_estruturas/e03_texto_buffer/programa.c, tests/casos/05_entrada_saida/i09_texto_truncamento/programa.c, tests/casos/05_entrada_saida/i11_tamanho_texto_acentos/programa.c, tests/casos/08_aplicacao/app_acervo/principal.c …. Os links da seção de evidência apontam para a linha exata; uma menção não prova que todos os ramos foram executados.
BG_TAMANHO_TEXTO depende de compilador, padrão C ou sistema operacional?
BG_TAMANHO_TEXTO exige C11 como o restante da linguagem; largura de tipo, libc e CRT continuam sendo os do alvo.
Ressalvas registradas: O resultado é em bytes da codificação de execução; não há decodificação UTF-8 dependente de OS.
O que acontece em caso de falha ou uso inválido?
Não há ressalva editorial específica para este nome. O comportamento em falha é o do corpo/expansão mostrado acima; não invente validação que o fonte não faz.