BG_TAMANHO_VETOR · TAMANHO_VETOR
Gerada por tools/gerar_documentacao.py. Definição: include/basicgol.h:123.
Calcula o número de elementos de um vetor real em escopo.
Tipo: macro com argumentos · Módulo/categoria: Programa e declarações.
Nomes equivalentes: TAMANHO_VETOR. Os testes de qualquer um desses nomes são reunidos nesta página.
Assinatura e expansão
#define BG_TAMANHO_VETOR(v) (sizeof(v) / sizeof((v)[0]))
Parâmetros formais: v.
Corpo da macro:
(sizeof(v) / sizeof((v)[0]))
Como funciona
Divide sizeof(v) por sizeof(v[0]). Em um parâmetro ponteiro, sizeof mede o ponteiro, não o array original.
- Passe capacidade explicitamente para funções; W-06 sinaliza o uso em parâmetros [] ou *.
Como este símbolo aparece nos testes
29 ocorrência(s) em 7 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/04_estruturas/e02_tamanho_vetor/programa.c
Contexto: e02_tamanho_vetor. Linhas: 9, 10, 11. Tipo de evidência: código; via TAMANHO_VETOR.
Linhas 7–12 · abrir contexto
VETOR(TEXTO, c, 2);
ESCREVAL(TAMANHO_VETOR(a));
ESCREVAL(TAMANHO_VETOR(b));
ESCREVAL(TAMANHO_VETOR(c));
FIM
tests/casos/04_estruturas/e09_funcao_vetor/programa.c
Contexto: e09_funcao_vetor. Linhas: 27, 30. Tipo de evidência: código; via TAMANHO_VETOR.
Linhas 25–31 · abrir contexto
v[i] = i + 1;
}
dobra(v, (INTEIRO) TAMANHO_VETOR(v));
ESCREVAL(v[0]);
ESCREVAL(v[3]);
ESCREVAL(soma(v, (INTEIRO) TAMANHO_VETOR(v)));
FIM
tests/casos/05_entrada_saida/i01_formatos/programa.c
Contexto: i01_formatos. Linhas: 27. Tipo de evidência: código; via TAMANHO_VETOR.
Linhas 25–28 · abrir contexto
ESCREVAL(ld);
ESCREVAL(s);
ESCREVAL(TAMANHO_VETOR("abcd") - 1); /* so para exercitar size_t */
FIM
tests/casos/06_negativos/n23_tamanho_de_ponteiro/programa.c
Contexto: n23_tamanho_de_ponteiro. Linhas: 21. Tipo de evidência: código; via TAMANHO_VETOR.
Linhas 19–22 · abrir contexto
v[0] = 1;
ESCREVAL(TAMANHO_VETOR(p));
FIM
tests/casos/09_tipos_expr/t11_texto_seguro/programa.c
Contexto: t11_texto_seguro. Linhas: 9, 11, 13, 17, 19, 23, 24, 26, 30, 32, 34, 36, 39, 41, 44, 57, 61, 62, 64. Tipo de evidência: código; via TAMANHO_VETOR.
Linhas 7–46 · abrir contexto
// --- cópia: 7 caracteres + NUL cabem em 8; 8 não cabem
ESCREVAL(COPIA_TEXTO(buf, TAMANHO_VETOR(buf), "abc"));
ESCREVA_TEXTO(buf); ESCREVA_LINHA();
ESCREVAL(COPIA_TEXTO(buf, TAMANHO_VETOR(buf), "1234567"));
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
ESCREVAL(JUNTA_TEXTO(buf, TAMANHO_VETOR(buf), "ab", "cd"));
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)
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"));
ESCREVAL(TAMANHO_TEXTO(buf)); // 0: 6 caracteres não caberiam
// --- trecho: quantidade limitada ao que existe, início além do fim = vazio
ESCREVAL(TRECHO_TEXTO(buf, TAMANHO_VETOR(buf), "abcdef", 2, 3));
ESCREVA_TEXTO(buf); ESCREVA_LINHA();
ESCREVAL(TRECHO_TEXTO(buf, TAMANHO_VETOR(buf), "abcdef", 4, 99));
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));
// --- formatação verificável (sem inspeção de formato pelo compilador)
ESCREVAL(FORMATA_TEXTO(buf, TAMANHO_VETOR(buf), "%d-%s", 42, "xy"));
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));
ESCREVA_TEXTO(dest); ESCREVA_LINHA();
Linhas 55–66 · 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)
COPIA_TEXTO(buf, TAMANHO_VETOR(buf), "abcdef");
ESCREVAL(TRECHO_TEXTO(buf, TAMANHO_VETOR(buf), buf, 2, 3));
ESCREVA_TEXTO(buf); ESCREVA_LINHA(); // cde
ESCREVAL(ACRESCENTA_TEXTO(buf, TAMANHO_VETOR(buf), buf)); // "cde"+"cde"
ESCREVA_TEXTO(buf); ESCREVA_LINHA(); // cdecde
ESCREVAL(ACRESCENTA_TEXTO(buf, 6, buf)); // nao cabe em 6: falha
tests/casos/13_avisos/w06_tamanho_de_parametro/programa.c
Contexto: w06_tamanho_de_parametro. Linhas: 5, 12. Tipo de evidência: código; via TAMANHO_VETOR.
Linhas 3–7 · abrir contexto
// W-06: TAMANHO_VETOR de parametro mede o ponteiro, nao o vetor (C-18)
PROCEDIMENTO mostra(INTEIRO v[], INTEIRO n) {
ESCREVAL(TAMANHO_VETOR(v));
ESCREVAL(n);
}
Linhas 10–13 · abrir contexto
VETOR(INTEIRO, dados, 4);
dados[0] = 1;
mostra(dados, TAMANHO_VETOR(dados));
FIM
tests/portabilidade/precedencia.c
Contexto: precedencia.c. Linhas: 67. Tipo de evidência: código; via TAMANHO_VETOR.
Linhas 65–69 · abrir contexto
AFIRME(ARREDONDA(2.5) == 3, "ARREDONDA(2.5) afasta do zero");
AFIRME(ARREDONDA(-2.5) == -3, "ARREDONDA(-2.5) afasta do zero");
AFIRME(TAMANHO_VETOR(v) * 2 == 6, "TAMANHO_VETOR em expressão");
AFIRME(BITS_DE(CARACTERE) == 8, "BITS_DE(CARACTERE)");
AFIRME(TAMANHO_DE(INTEIRO8) == 1, "TAMANHO_DE(INTEIRO8)");
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_VETOR→ tests/casos/04_estruturas/e02_tamanho_vetor/programa.c, tests/casos/04_estruturas/e09_funcao_vetor/programa.c, tests/casos/05_entrada_saida/i01_formatos/programa.c, tests/casos/06_negativos/n23_tamanho_de_ponteiro/programa.c, tests/casos/09_tipos_expr/t11_texto_seguro/programa.c …
Compiladores, padrão C e sistema operacional
Condições que envolvem a definição:
defined(BASICGOL_H)(fonte)
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_VETORe a forma canônicaBG_TAMANHO_VETORsã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_VETOR. 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_VETOR faz?
Calcula o número de elementos de um vetor real em escopo.
Para que exatamente BG_TAMANHO_VETOR expande?
O pré-processador substitui BG_TAMANHO_VETOR pelo texto abaixo, sem criar função nem avaliar argumentos por conta própria.
Parâmetros formais: v.
(sizeof(v) / sizeof((v)[0]))
Como BG_TAMANHO_VETOR aparece em código real deste repositório?
Uso extraído de tests/casos/04_estruturas/e02_tamanho_vetor/programa.c:7, com as linhas vizinhas preservadas:
VETOR(TEXTO, c, 2);
ESCREVAL(TAMANHO_VETOR(a));
ESCREVAL(TAMANHO_VETOR(b));
ESCREVAL(TAMANHO_VETOR(c));
Onde BG_TAMANHO_VETOR é exercitado nos testes?
Há 29 ocorrência(s) em 7 arquivo(s): tests/casos/04_estruturas/e02_tamanho_vetor/programa.c, tests/casos/04_estruturas/e09_funcao_vetor/programa.c, tests/casos/05_entrada_saida/i01_formatos/programa.c, tests/casos/06_negativos/n23_tamanho_de_ponteiro/programa.c, tests/casos/09_tipos_expr/t11_texto_seguro/programa.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_VETOR depende de compilador, padrão C ou sistema operacional?
BG_TAMANHO_VETOR exige C11 como o restante da linguagem; largura de tipo, libc e CRT continuam sendo os do alvo.
Quais armadilhas preciso evitar ao usar BG_TAMANHO_VETOR?
O contrato editorial registra: “Passe capacidade explicitamente para funções; W-06 sinaliza o uso em parâmetros [] ou *.”