Pular para o conteúdo principal

BG_PARE · PARE

Página gerada do fonte

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

Interrompe o laço ou switch mais interno.

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

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

Assinatura e expansão​

#define BG_PARE break

Corpo da macro:

break

Como funciona​

Expande para break; não sai de múltiplos níveis nem de funções.

Como este símbolo aparece nos testes​

28 ocorrência(s) em 14 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/c07_enquanto_pare/programa.c​

Contexto: c07_enquanto_pare. Linhas: 8. Tipo de evidência: código; via PARE.

Linhas 6–10 · abrir contexto
i = i + 1;
SE i == 4 ENTAO
PARE;
FIM_SE
FIM_ENQUANTO

Ver no GitHub

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

Contexto: c18_escolha_pare. Linhas: 8, 11. Tipo de evidência: código; via PARE.

Linhas 6–13 · abrir contexto
CASO 1:
ESCREVAL("novo");
PARE;
CASO 2:
ESCREVAL("abrir");
PARE;
CONTRARIO:
ESCREVAL("invalido");

Ver no GitHub

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

Contexto: c20_escolha_bloco. Linhas: 10. Tipo de evidência: código; via PARE.

Linhas 8–12 · abrir contexto
INTEIRO quadrado = 3 * 3;
ESCREVAL(quadrado);
PARE;
}
CONTRARIO:

Ver no GitHub

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

Contexto: c21_laco_com_condicoes. Linhas: 11. Tipo de evidência: código; via PARE.

Linhas 9–13 · abrir contexto
i = i + 1;
SE i > 50 ENTAO
PARE;
FIM_SE
SE i MOD 7 == 0 E i > 10 ENTAO

Ver no GitHub

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

Contexto: c22_escolha_com_chamada. Linhas: 11, 19. Tipo de evidência: código; via PARE.

Linhas 9–13 · abrir contexto
CASO 3:
ESCREVAL("tres");
PARE;
CONTRARIO:
ESCREVAL("outro");

Ver no GitHub

Linhas 17–21 · abrir contexto
CASO 8:
ESCREVAL("oito");
PARE;
CONTRARIO:
ESCREVAL("outro");

Ver no GitHub

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

Contexto: c28_aninhados_pare_prossiga. Linhas: 13. Tipo de evidência: código; via PARE.

Linhas 11–15 · abrir contexto
PARA (j, 1, 5) {
SE j == 3 ENTAO
PARE;
FIM_SE
total = total + 1;

Ver no GitHub

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

Contexto: c29_saida_de_dois_lacos. Linhas: 18, 22, 34, 38. Tipo de evidência: código; via PARE.

Linhas 16–24 · abrir contexto
ai = i;
aj = j;
PARE;
FIM_SE
}
SE achou ENTAO
PARE;
FIM_SE
}

Ver no GitHub

Linhas 32–40 · abrir contexto
SE i * j == 7 ENTAO
achou = 1;
PARE;
FIM_SE
}
SE achou ENTAO
PARE;
FIM_SE
}

Ver no GitHub

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

Contexto: c35_escolha_no_laco. Linhas: 15, 19. Tipo de evidência: código; via PARE.

Linhas 13–21 · abrir contexto
CASO 1:
total = total + 1;
PARE; // sai do ESCOLHA, não do PARA
CASO 2:
CASO 3: // rótulos vazios agrupados
total = total + 10;
PARE;
CONTRARIO:
total = total + 100;

Ver no GitHub

tests/casos/06_negativos/n17_pare_fora_de_laco/programa.c​

Contexto: n17_pare_fora_de_laco. Linhas: 6. Tipo de evidência: código; via PARE.

Linhas 4–7 · abrir contexto
INICIO
ESCREVAL("x");
PARE;
FIM

Ver no GitHub

tests/casos/06_negativos/n20_escolha_com_virgula/programa.c​

Contexto: n20_escolha_com_virgula. Linhas: 10. Tipo de evidência: código; via PARE.

Linhas 8–12 · abrir contexto
CASO 1:
ESCREVAL("um");
PARE;
FIM_ESCOLHA
FIM

Ver no GitHub

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

Contexto: app_acervo. Linhas: 75. Tipo de evidência: código; via PARE.

Linhas 73–77 · abrir contexto
FIM_ENQUANTO
SE NAO trocou ENTAO
PARE;
FIM_SE
i = i + 1;

Ver no GitHub

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

Contexto: app_acervo. Linhas: 63, 94, 102. Tipo de evidência: código; via PARE.

Linhas 61–65 · abrir contexto
REPITA
SE NAO LEIA_TEXTO(comando, 64) ENTAO
PARE; // fim da entrada
FIM_SE
SE IGUAL(TAMANHO_TEXTO(comando), 0) ENTAO

Ver no GitHub

Linhas 92–96 · abrir contexto
recusados = recusados + 1;
FIM_SE
PARE;
CASO 'd':
SE devolve(id) ENTAO

Ver no GitHub

Linhas 100–104 · abrir contexto
recusados = recusados + 1;
FIM_SE
PARE;
CONTRARIO:
ESCREVA_ERRO("comando desconhecido\n");

Ver no GitHub

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

Contexto: w04_controle_modificado. Linhas: 8. Tipo de evidência: código; via PARE.

Linhas 6–10 · abrir contexto
PARA (i, 0, 9) {
SE i > 3 ENTAO
PARE;
FIM_SE
i = i + 1;

Ver no GitHub

tests/portabilidade/controle.c​

Contexto: controle.c. Linhas: 104, 108, 120, 133, 138, 173, 177. Tipo de evidência: código; via PARE.

Linhas 102–110 · abrir contexto
CASO 1:
SE VERDADEIRO ENTAO
PARE; /* sai do ESCOLHA, não do PARA */
FIM_SE
CASO 2:
total = total + 2;
PARE;
CONTRARIO:
total = total + 3;

Ver no GitHub

Linhas 118–122 · abrir contexto
CASO 3:
total = 30;
PARE;
CONTRARIO:
total = 99;

Ver no GitHub

Linhas 131–140 · abrir contexto
CASO 5:
total = 25;
PARE;
CONTRARIO:
total = 12;
FIM_ESCOLHA
total = total + 1;
PARE;
CONTRARIO:
total = 0;

Ver no GitHub

Linhas 171–179 · abrir contexto
achou = VERDADEIRO;
alvo = i * 10 + j;
PARE;
FIM_SE
}
SE achou ENTAO
PARE;
FIM_SE
}

Ver no GitHub

Também aparece na tabela de expansão conferida por cc -E -dM: L21.

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

Em uma frase, o que BG_PARE faz?​

Interrompe o laço ou switch mais interno.

Para que exatamente BG_PARE expande?​

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

break

Como BG_PARE aparece em código real deste repositório?​

Uso extraído de tests/casos/03_controle/c07_enquanto_pare/programa.c:6, com as linhas vizinhas preservadas:

i = i + 1;
SE i == 4 ENTAO
PARE;
FIM_SE
FIM_ENQUANTO

Onde BG_PARE é exercitado nos testes?​

Há 28 ocorrência(s) em 14 arquivo(s): tests/casos/03_controle/c07_enquanto_pare/programa.c, tests/casos/03_controle/c18_escolha_pare/programa.c, tests/casos/03_controle/c20_escolha_bloco/programa.c, tests/casos/03_controle/c21_laco_com_condicoes/programa.c, tests/casos/03_controle/c22_escolha_com_chamada/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_PARE depende de compilador, padrão C ou sistema operacional?​

BG_PARE exige C11 como o restante da linguagem; largura de tipo, libc e CRT continuam sendo os do alvo.

O que acontece em caso de falha ou uso inválido?​

Não há ressalva editorial específica para este nome. O comportamento em falha é o do corpo/expansão mostrado acima; não invente validação que o fonte não faz.