BG_VETOR · VETOR
Gerada por tools/gerar_documentacao.py. Definição: include/basicgol.h:122.
Declara um vetor C de tipo, nome e capacidade.
Tipo: macro com argumentos · Módulo/categoria: Programa e declarações.
Nomes equivalentes: VETOR. Os testes de qualquer um desses nomes são reunidos nesta página.
Assinatura e expansão
#define BG_VETOR(t, n, k) t n[k]
Parâmetros formais: t, n, k.
Corpo da macro:
t n[k]
Como funciona
Expande para t n[k]; índices vão de zero a k-1 e não há verificação automática de limites.
- Capacidade deve ser compatível com C11 e com o compilador; evite VLA para manter o alvo MSVC.
- Não há ownership nem redimensionamento automático.
Comentário do fonte
--- declarações ---
Como este símbolo aparece nos testes
13 ocorrência(s) em 11 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/e01_vetor_basico/programa.c
Contexto: e01_vetor_basico. Linhas: 5. Tipo de evidência: código; via VETOR.
Linhas 3–7 · abrir contexto
INICIO
VETOR(INTEIRO, v, 5);
INTEIRO i = 0;
INTEIRO soma = 0;
tests/casos/04_estruturas/e02_tamanho_vetor/programa.c
Contexto: e02_tamanho_vetor. Linhas: 5, 6, 7. Tipo de evidência: código; via VETOR.
Linhas 3–9 · abrir contexto
INICIO
VETOR(INTEIRO, a, 7);
VETOR(REAL, b, 3);
VETOR(TEXTO, c, 2);
ESCREVAL(TAMANHO_VETOR(a));
tests/casos/04_estruturas/e06_vetor_registros/programa.c
Contexto: e06_vetor_registros. Linhas: 10. Tipo de evidência: código; via VETOR.
Linhas 8–12 · abrir contexto
INICIO
VETOR(Aluno, turma, 3);
INTEIRO i = 0;
REAL total = 0.0;
tests/casos/04_estruturas/e09_funcao_vetor/programa.c
Contexto: e09_funcao_vetor. Linhas: 22. Tipo de evidência: código; via VETOR.
Linhas 20–24 · abrir contexto
INICIO
VETOR(INTEIRO, v, 4);
INTEIRO i = 0;
PARA (i, 0, 3) {
tests/casos/06_negativos/n06_vetor_sintaxe_portugol/programa.c
Contexto: n06_vetor_sintaxe_portugol. Linhas: 5. Tipo de evidência: código; via VETOR.
Linhas 3–6 · abrir contexto
// a forma do Portugol "VETOR INTEIRO v DE 10" nao existe em BASICGOL
INICIO
VETOR INTEIRO v DE 10;
FIM
tests/casos/06_negativos/n23_tamanho_de_ponteiro/programa.c
Contexto: n23_tamanho_de_ponteiro. Linhas: 17. Tipo de evidência: código; via VETOR.
Linhas 15–19 · abrir contexto
INICIO
VETOR(INTEIRO, v, 4);
INTEIRO *p = v;
tests/casos/08_aplicacao/app_acervo/acervo.c
Contexto: app_acervo. Linhas: 4. Tipo de evidência: código; via VETOR.
Linhas 2–6 · abrir contexto
#include "acervo.h"
ESTATICO VETOR(Livro, acervo, ACERVO_MAX);
ESTATICO INTEIRO total = 0;
tests/casos/13_avisos/w06_tamanho_de_parametro/programa.c
Contexto: w06_tamanho_de_parametro. Linhas: 10. Tipo de evidência: código; via VETOR.
Linhas 8–12 · abrir contexto
INICIO
VETOR(INTEIRO, dados, 4);
dados[0] = 1;
mostra(dados, TAMANHO_VETOR(dados));
tests/casos/13_avisos/w07_tamanho_constante/programa.c
Contexto: w07_tamanho_constante. Linhas: 7. Tipo de evidência: código; via VETOR.
Linhas 5–9 · abrir contexto
INICIO
VETOR(INTEIRO, v, k_n);
v[0] = 1;
ESCREVAL(v[0]);
tests/run.sh
Contexto: run.sh. Linhas: 219. Tipo de evidência: código; via VETOR.
Linhas 217–221 · abrir contexto
# versão
cat > "$T_TMP/h7.c" <<'EOF'
#include <basicgol.h>
_Static_assert(BG_VERSAO_MINIMA(1, 0), "exige 1.0");
INICIO
tests/run.sh · heredoc na linha 505
Contexto: C incorporado no runner (linha 505). Linhas: 508. Tipo de evidência: código; via VETOR.
Linhas 506–510 · abrir contexto
CONSTANTE INTEIRO k_n = 4;
INICIO
VETOR(INTEIRO, v, k_n);
v[0] = 1;
ESCREVAL(v[0]);
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.
VETOR→ tests/casos/04_estruturas/e01_vetor_basico/programa.c, tests/casos/04_estruturas/e02_tamanho_vetor/programa.c, tests/casos/04_estruturas/e06_vetor_registros/programa.c, tests/casos/04_estruturas/e09_funcao_vetor/programa.c, tests/casos/06_negativos/n06_vetor_sintaxe_portugol/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
VETORe a forma canônicaBG_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_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_VETOR faz?
Declara um vetor C de tipo, nome e capacidade.
Para que exatamente BG_VETOR expande?
O pré-processador substitui BG_VETOR pelo texto abaixo, sem criar função nem avaliar argumentos por conta própria.
Parâmetros formais: t, n, k.
t n[k]
Como BG_VETOR aparece em código real deste repositório?
Uso extraído de tests/casos/04_estruturas/e01_vetor_basico/programa.c:3, com as linhas vizinhas preservadas:
INICIO
VETOR(INTEIRO, v, 5);
INTEIRO i = 0;
INTEIRO soma = 0;
Onde BG_VETOR é exercitado nos testes?
Há 13 ocorrência(s) em 11 arquivo(s): tests/casos/04_estruturas/e01_vetor_basico/programa.c, tests/casos/04_estruturas/e02_tamanho_vetor/programa.c, tests/casos/04_estruturas/e06_vetor_registros/programa.c, tests/casos/04_estruturas/e09_funcao_vetor/programa.c, tests/casos/06_negativos/n06_vetor_sintaxe_portugol/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_VETOR depende de compilador, padrão C ou sistema operacional?
BG_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_VETOR?
O contrato editorial registra: “Capacidade deve ser compatível com C11 e com o compilador; evite VLA para manter o alvo MSVC.” “Não há ownership nem redimensionamento automático.”