Pular para o conteúdo principal

BG_TAMANHO_VETOR · TAMANHO_VETOR

Página gerada do fonte

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.

Contrato e armadilhas
  • 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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

Linhas 10–13 · abrir contexto
VETOR(INTEIRO, dados, 4);
dados[0] = 1;
mostra(dados, TAMANHO_VETOR(dados));
FIM

Ver no GitHub

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

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)
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_VETOR e a forma canônica BG_TAMANHO_VETOR 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_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 *.”