Pular para o conteúdo principal

BG_VETOR · VETOR

Página gerada do fonte

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.

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

Ver no GitHub

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

Ver no GitHub

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;

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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;

Ver no GitHub

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;

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

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 VETOR e a forma canônica BG_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_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.”