Pular para o conteúdo principal

BG_PARA · PARA

Página gerada do fonte

Gerada por tools/gerar_documentacao.py. Definição: include/basicgol.h:152.

Laço contado M0 com limite superior inclusivo e passo +1.

Tipo: macro com argumentos · Módulo/categoria: Programa e declarações.

Nomes equivalentes: PARA. Os testes de qualquer um desses nomes são reunidos nesta página.

Assinatura e expansão​

#define BG_PARA(i, a, b) for ((i) = (a); (i) <= (b); ++(i))

Parâmetros formais: i, a, b.

Corpo da macro:

for ((i) = (a); (i) <= (b); ++(i))

Como funciona​

Expande para for ((i)=(a); (i)<=(b); ++(i)). O corpo usa chaves C ou um comando simples.

Contrato e armadilhas
  • Os argumentos são expressões de macro: efeitos colaterais podem ser avaliados mais de uma vez.
  • O incremento de um contador no limite máximo assinado pode estourar; escolha limites representáveis.
  • A forma açucarada PARA i DE a ATE b FACA é M1, não esta macro.

Exemplo de uso​

INTEIRO i = 0;
PARA (i, 1, 3) { ESCREVAL(i); }

Como este símbolo aparece nos testes​

49 ocorrência(s) em 26 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/03_controle/c11_para_basico/programa.c​

Contexto: c11_para_basico. Linhas: 5. Tipo de evidência: código; via PARA.

Linhas 3–7 · abrir contexto
INICIO
INTEIRO i = 0;
PARA (i, 1, 5) {
ESCREVA(i);
ESCREVA(" ");

Ver no GitHub

tests/casos/03_controle/c12_para_vazio/programa.c​

Contexto: c12_para_vazio. Linhas: 6. Tipo de evidência: código; via PARA.

Linhas 4–8 · abrir contexto
INICIO
INTEIRO i = 0;
PARA (i, 5, 1) {
ESCREVAL("nunca");
}

Ver no GitHub

tests/casos/03_controle/c13_para_aninhado/programa.c​

Contexto: c13_para_aninhado. Linhas: 6, 7. Tipo de evidência: código; via PARA.

Linhas 4–9 · abrir contexto
INTEIRO i = 0;
INTEIRO j = 0;
PARA (i, 1, 3) {
PARA (j, 1, 2) {
ESCREVA(i);
ESCREVA("x");

Ver no GitHub

tests/casos/03_controle/c24_zero_iteracoes/programa.c​

Contexto: c24_zero_iteracoes. Linhas: 9. Tipo de evidência: código; via PARA.

Linhas 7–11 · abrir contexto
INTEIRO n = 0;

PARA (i, 5, 1) { // fim < inicio
n = n + 1;
}

Ver no GitHub

tests/casos/03_controle/c25_limites_inclusivos/programa.c​

Contexto: c25_limites_inclusivos. Linhas: 9, 14, 34. Tipo de evidência: código; via PARA.

Linhas 7–16 · abrir contexto
INTEIRO n = 0;

PARA (i, 4, 4) { // um único valor
n = n + 1;
ESCREVAL(i); // 4
}

PARA (i, 1, 3) { // extremos incluídos
ESCREVA_FMT("%d ", i);
}

Ver no GitHub

Linhas 32–36 · abrir contexto
ESCREVA_LINHA(); // 10 5 0

PARA (i, -2, 1) { // faixa que cruza zero
ESCREVA_FMT("%d ", i);
}

Ver no GitHub

tests/casos/03_controle/c28_aninhados_pare_prossiga/programa.c​

Contexto: c28_aninhados_pare_prossiga. Linhas: 10, 11, 23, 24. Tipo de evidência: código; via PARA.

Linhas 8–13 · abrir contexto

// PARE: o laço interno para em j == 3 (j = 1 e 2 contam); o externo segue.
PARA (i, 1, 3) {
PARA (j, 1, 5) {
SE j == 3 ENTAO
PARE;

Ver no GitHub

Linhas 21–26 · abrir contexto
// PROSSIGA: pula só o j par, dentro de cada i; o +10 externo roda 3 vezes.
total = 0;
PARA (i, 1, 3) {
PARA (j, 1, 4) {
SE j MOD 2 == 0 ENTAO
PROSSIGA;

Ver no GitHub

tests/casos/03_controle/c29_saida_de_dois_lacos/programa.c​

Contexto: c29_saida_de_dois_lacos. Linhas: 12, 13, 30, 31. Tipo de evidência: código; via PARA.

Linhas 10–15 · abrir contexto
INTEIRO aj = 0;

PARA (i, 1, 4) {
PARA (j, 1, 4) {
SE i * j == 6 ENTAO
achou = 1;

Ver no GitHub

Linhas 28–33 · abrir contexto
// sem par que dê 7: a bandeira nunca liga e os dois laços terminam sozinhos
achou = 0;
PARA (i, 1, 4) {
PARA (j, 1, 4) {
SE i * j == 7 ENTAO
achou = 1;

Ver no GitHub

tests/casos/03_controle/c32_para_prossiga_avanca/programa.c​

Contexto: c32_para_prossiga_avanca. Linhas: 8. Tipo de evidência: código; via PARA.

Linhas 6–10 · abrir contexto
INTEIRO i = 0;
INTEIRO vistos = 0;
PARA (i, 1, 5) {
SE i < 5 ENTAO
PROSSIGA;

Ver no GitHub

tests/casos/03_controle/c33_condicoes_aninhadas/programa.c​

Contexto: c33_condicoes_aninhadas. Linhas: 9, 10. Tipo de evidência: código; via PARA.

Linhas 7–12 · abrir contexto
INTEIRO b = 0;

PARA (a, 0, 1) {
PARA (b, 0, 1) {
SE a == 1 ENTAO
SE b == 1 ENTAO

Ver no GitHub

tests/casos/03_controle/c34_faixas_senao_se/programa.c​

Contexto: c34_faixas_senao_se. Linhas: 6. Tipo de evidência: código; via PARA.

Linhas 4–8 · abrir contexto
INICIO
INTEIRO nota = 0;
PARA (nota, 4, 10) {
ESCREVA_FMT("%d: ", nota);
SE nota < 5 ENTAO

Ver no GitHub

tests/casos/03_controle/c35_escolha_no_laco/programa.c​

Contexto: c35_escolha_no_laco. Linhas: 9. Tipo de evidência: código; via PARA.

Linhas 7–11 · abrir contexto
INTEIRO total = 0;

PARA (i, 0, 5) {
ESCOLHA (i)
CASO 0:

Ver no GitHub

tests/casos/03_controle/c37_laco_interno_vazio/programa.c​

Contexto: c37_laco_interno_vazio. Linhas: 8, 9. Tipo de evidência: código; via PARA.

Linhas 6–11 · abrir contexto
INTEIRO i = 0;
INTEIRO j = 0;
PARA (i, 1, 3) {
PARA (j, 5, 4) { // vazio
ESCREVAL("nunca");
}

Ver no GitHub

tests/casos/04_estruturas/e01_vetor_basico/programa.c​

Contexto: e01_vetor_basico. Linhas: 9, 12. Tipo de evidência: código; via PARA.

Linhas 7–14 · abrir contexto
INTEIRO soma = 0;

PARA (i, 0, 4) {
v[i] = i * i;
}
PARA (i, 0, 4) {
soma = soma + v[i];
}

Ver no GitHub

tests/casos/04_estruturas/e06_vetor_registros/programa.c​

Contexto: e06_vetor_registros. Linhas: 18. Tipo de evidência: código; via PARA.

Linhas 16–20 · abrir contexto
turma[2].nome = "Caio"; turma[2].nota = 7.5;

PARA (i, 0, 2) {
ESCREVA_TEXTO(turma[i].nome);
ESCREVA(": ");

Ver no GitHub

tests/casos/04_estruturas/e09_funcao_vetor/programa.c​

Contexto: e09_funcao_vetor. Linhas: 7, 15, 24. Tipo de evidência: código; via PARA.

Linhas 5–9 · abrir contexto
PROCEDIMENTO dobra(INTEIRO v[], INTEIRO n) {
INTEIRO i = 0;
PARA (i, 0, n - 1) {
v[i] = v[i] * 2;
}

Ver no GitHub

Linhas 13–17 · abrir contexto
INTEIRO i = 0;
INTEIRO total = 0;
PARA (i, 0, n - 1) {
total = total + v[i];
}

Ver no GitHub

Linhas 22–26 · abrir contexto
VETOR(INTEIRO, v, 4);
INTEIRO i = 0;
PARA (i, 0, 3) {
v[i] = i + 1;
}

Ver no GitHub

tests/casos/07_multiarquivo/m01_modulos/matematica.c​

Contexto: m01_modulos. Linhas: 36. Tipo de evidência: código; via PARA.

Linhas 34–38 · abrir contexto
PROCEDIMENTO tabuada(INTEIRO n) {
INTEIRO i = 0;
PARA (i, 1, 5) {
ESCREVA_FMT("%d x %d = %d\n", n, i, n * i);
}

Ver no GitHub

tests/casos/08_aplicacao/app_acervo/acervo.c​

Contexto: app_acervo. Linhas: 103, 117. Tipo de evidência: código; via PARA.

Linhas 101–105 · abrir contexto
INTEIRO soma = 0;
INTEIRO i = 0;
PARA (i, 0, total - 1) {
soma = soma + acervo[i].ano;
}

Ver no GitHub

Linhas 115–119 · abrir contexto
REAL soma = 0.0;
INTEIRO i = 0;
PARA (i, 0, total - 1) {
INTEIRO idade = 2026 - acervo[i].ano;
soma = soma + POTENCIA(idade, 2);

Ver no GitHub

tests/casos/08_aplicacao/app_acervo/relatorio.c​

Contexto: app_acervo. Linhas: 11, 28. Tipo de evidência: código; via PARA.

Linhas 9–13 · abrir contexto
ESCREVA_FMT("%-3s %-22s %-18s %-5s %s\n", "id", "titulo", "autor", "ano", "situacao");

PARA (i, 0, quantidade() - 1) {
// livros sem titulo ficam fora da listagem (PROSSIGA)
SE IGUAL(TAMANHO_TEXTO(acervo_titulo(i)), 0) ENTAO

Ver no GitHub

Linhas 26–30 · abrir contexto
INTEIRO menor = acervo_ano(0);
INTEIRO maior = acervo_ano(0);
PARA (i, 0, quantidade() - 1) {
menor = MINIMO(menor, acervo_ano(i));
maior = MAXIMO(maior, acervo_ano(i));

Ver no GitHub

tests/casos/12_negativos_m1/t05_para_sem_de/programa.c​

Contexto: t05_para_sem_de. Linhas: 4. Tipo de evidência: código; via PARA.

Linhas 2–6 · abrir contexto

INICIO
PARA i ATE 10 FACA
ESCREVAL(i);
FIM_PARA

Ver no GitHub

tests/casos/12_negativos_m1/t06_para_sem_ate/programa.c​

Contexto: t06_para_sem_ate. Linhas: 4. Tipo de evidência: código; via PARA.

Linhas 2–6 · abrir contexto

INICIO
PARA i DE 1 FACA
ESCREVAL(i);
FIM_PARA

Ver no GitHub

tests/casos/13_avisos/w04_controle_modificado/programa.c​

Contexto: w04_controle_modificado. Linhas: 6. Tipo de evidência: código; via PARA.

Linhas 4–8 · abrir contexto
INICIO
INTEIRO i = 0;
PARA (i, 0, 9) {
SE i > 3 ENTAO
PARE;

Ver no GitHub

tests/portabilidade/cabecalhos_tu3.c​

Contexto: cabecalhos_tu3.c. Linhas: 30. Tipo de evidência: código; via BG_PARA.

Linhas 28–32 · abrir contexto
BG_FIM_SE

BG_PARA (i, 1, 2) {
total = total + i;
}

Ver no GitHub

tests/portabilidade/controle.c​

Contexto: controle.c. Linhas: 25, 31, 37, 38, 100, 168, 169, 184. Tipo de evidência: código; via PARA.

Linhas 23–27 · abrir contexto
/* ------------------------------------------------ PARA inclusivo */
total = 0;
PARA (i, 1, 3) {
total = total + i;
}

Ver no GitHub

Linhas 29–33 · abrir contexto

total = 0;
PARA (i, 3, 1) {
total = total + 1; /* limite menor que o início: 0 voltas */
}

Ver no GitHub

Linhas 35–40 · abrir contexto

total = 0;
PARA (i, 0, 2) {
PARA (j, 0, 2) {
total = total + 1;
}

Ver no GitHub

Linhas 98–102 · abrir contexto
/* ------------------------------------------- ESCOLHA e PARE */
total = 0;
PARA (i, 1, 3) {
ESCOLHA (i)
CASO 1:

Ver no GitHub

Linhas 166–171 · abrir contexto
achou = FALSO;
alvo = -1;
PARA (i, 0, 2) {
PARA (j, 0, 2) {
SE i * 3 + j == 4 ENTAO
achou = VERDADEIRO;

Ver no GitHub

Linhas 182–186 · abrir contexto
/* ------------------------------------ PROSSIGA em PARA (avança i) */
total = 0;
PARA (i, 0, 4) {
SE i MOD 2 == 0 ENTAO
PROSSIGA;

Ver no GitHub

tests/run.sh · heredoc na linha 341​

Contexto: C incorporado no runner (linha 341). Linhas: 355. Tipo de evidência: código; via PARA.

Linhas 353–357 · abrir contexto
CONTRARIO:
FIM_ESCOLHA
PARA i DE 1 ATE 3 FACA
FIM_PARA
FIM

Ver no GitHub

tests/run_portabilidade.sh​

Contexto: run_portabilidade.sh. Linhas: 189. Tipo de evidência: código; via PARA.

Linhas 187–191 · abrir contexto
INTEIRO i = 0;
LOGICO b = VERDADEIRO;
TEXTO_FIXO(buf, 16);

SE b E (i < 1) ENTAO

Ver no GitHub

tests/run_portabilidade.sh · heredoc na linha 183​

Contexto: C incorporado no runner (linha 183). Linhas: 194. Tipo de evidência: código; via PARA.

Linhas 192–196 · abrir contexto
ESCREVAL("x");
FIM_SE
PARA (i, 0, 1) {
ESCREVA(i);
}

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 PARA e a forma canônica BG_PARA 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_PARA. As respostas repetem apenas o que o repositório mostra; quando não há evidência, isso é dito.

Em uma frase, o que BG_PARA faz?​

Laço contado M0 com limite superior inclusivo e passo +1.

Para que exatamente BG_PARA expande?​

O pré-processador substitui BG_PARA pelo texto abaixo, sem criar função nem avaliar argumentos por conta própria.

Parâmetros formais: i, a, b.

for ((i) = (a); (i) <= (b); ++(i))

Como usar BG_PARA em um programa?​

Exemplo editorial mantido em tools/documentacao/contratos.json e conferido contra a assinatura real:

INTEIRO i = 0;
PARA (i, 1, 3) { ESCREVAL(i); }

Onde BG_PARA é exercitado nos testes?​

Há 49 ocorrência(s) em 26 arquivo(s): tests/casos/03_controle/c11_para_basico/programa.c, tests/casos/03_controle/c12_para_vazio/programa.c, tests/casos/03_controle/c13_para_aninhado/programa.c, tests/casos/03_controle/c24_zero_iteracoes/programa.c, tests/casos/03_controle/c25_limites_inclusivos/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_PARA depende de compilador, padrão C ou sistema operacional?​

BG_PARA 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_PARA?​

O contrato editorial registra: “Os argumentos são expressões de macro: efeitos colaterais podem ser avaliados mais de uma vez.” “O incremento de um contador no limite máximo assinado pode estourar; escolha limites representáveis.” “A forma açucarada PARA i DE a ATE b FACA é M1, não esta macro.”