Pular para o conteúdo principal

BG_TAMANHO_TEXTO · TAMANHO_TEXTO

Página gerada do fonte

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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)

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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)

Ver no GitHub

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

Ver no GitHub

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 */
}

Ver no GitHub

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.

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.

Não confunda implementação com certificação

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_TEXTO e a forma canônica BG_TAMANHO_TEXTO são a mesma macro; escolha uma por arquivo para não misturar estilos.
  • Rode make test (ou make test-biblioteca para 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.