BG_ESCOLHA · ESCOLHA
Gerada por tools/gerar_documentacao.py. Definição: include/basicgol.h:146.
Abre switch C para seleção por valores inteiros/enumerados.
Tipo: macro com argumentos · Módulo/categoria: Programa e declarações.
Nomes equivalentes: ESCOLHA. Os testes de qualquer um desses nomes são reunidos nesta página.
Assinatura e expansão
#define BG_ESCOLHA(e) switch (e) {
Parâmetros formais: e.
Corpo da macro:
switch (e) {
Como funciona
Expande para switch (e) {. CASO e CONTRARIO são case/default; PARE evita fallthrough.
- Sem PARE, a execução continua no próximo caso, como em C.
Como este símbolo aparece nos testes
16 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/03_controle/c18_escolha_pare/programa.c
Contexto: c18_escolha_pare. Linhas: 5. Tipo de evidência: código; via ESCOLHA.
Linhas 3–7 · abrir contexto
PROCEDIMENTO menu(INTEIRO opcao) {
ESCOLHA (opcao)
CASO 1:
ESCREVAL("novo");
tests/casos/03_controle/c19_escolha_fallthrough/programa.c
Contexto: c19_escolha_fallthrough. Linhas: 19. Tipo de evidência: código; via ESCOLHA.
Linhas 17–21 · abrir contexto
INICIO
ESCOLHA (2)
CASO 1:
ESCREVA("um ");
tests/casos/03_controle/c20_escolha_bloco/programa.c
Contexto: c20_escolha_bloco. Linhas: 6. Tipo de evidência: código; via ESCOLHA.
Linhas 4–8 · abrir contexto
INICIO
ESCOLHA (3)
CASO 3: {
INTEIRO quadrado = 3 * 3;
tests/casos/03_controle/c22_escolha_com_chamada/programa.c
Contexto: c22_escolha_com_chamada. Linhas: 8, 16. Tipo de evidência: código; via ESCOLHA.
Linhas 6–10 · abrir contexto
INICIO
ESCOLHA (soma(1, 2))
CASO 3:
ESCREVAL("tres");
Linhas 14–18 · abrir contexto
FIM_ESCOLHA
ESCOLHA (soma(2, 2) * 2)
CASO 8:
ESCREVAL("oito");
tests/casos/03_controle/c35_escolha_no_laco/programa.c
Contexto: c35_escolha_no_laco. Linhas: 10. Tipo de evidência: código; via ESCOLHA.
Linhas 8–12 · abrir contexto
PARA (i, 0, 5) {
ESCOLHA (i)
CASO 0:
PROSSIGA; // i = 0: pula o +1000 abaixo
tests/casos/04_estruturas/e07_enumeracao/programa.c
Contexto: e07_enumeracao. Linhas: 11. Tipo de evidência: código; via ESCOLHA.
Linhas 9–13 · abrir contexto
FUNCAO TEXTO nome_da(Cor c) {
ESCOLHA (c)
CASO VERMELHO:
RETORNE "vermelho";
tests/casos/06_negativos/n20_escolha_com_virgula/programa.c
Contexto: n20_escolha_com_virgula. Linhas: 7. Tipo de evidência: código; via ESCOLHA.
Linhas 5–9 · abrir contexto
INTEIRO a = 1;
INTEIRO b = 2;
ESCOLHA (a, b)
CASO 1:
ESCREVAL("um");
tests/casos/08_aplicacao/app_acervo/acervo.c
Contexto: app_acervo. Linhas: 125. Tipo de evidência: código; via ESCOLHA.
Linhas 123–127 · abrir contexto
FUNCAO TEXTO nome_situacao(Situacao s) {
ESCOLHA (s)
CASO DISPONIVEL:
RETORNE "disponivel";
tests/casos/08_aplicacao/app_acervo/principal.c
Contexto: app_acervo. Linhas: 71. Tipo de evidência: código; via ESCOLHA.
Linhas 69–73 · abrir contexto
INTEIRO id = le_id(comando);
ESCOLHA (comando[0])
CASO 'f':
sair = VERDADEIRO;
tests/portabilidade/controle.c
Contexto: controle.c. Linhas: 101, 117, 128, 130, 142. Tipo de evidência: código; via ESCOLHA.
Linhas 99–103 · abrir contexto
total = 0;
PARA (i, 1, 3) {
ESCOLHA (i)
CASO 1:
SE VERDADEIRO ENTAO
Linhas 115–119 · abrir contexto
total = 0;
ESCOLHA (soma(1, 2)) /* vírgula de nível superior em macro */
CASO 3:
total = 30;
Linhas 126–132 · abrir contexto
/* normaliza para a mesma superfície o aninhamento de ESCOLHA */
total = 0;
ESCOLHA (2)
CASO 2:
ESCOLHA (5)
CASO 5:
total = 25;
Linhas 140–144 · abrir contexto
total = 0;
FIM_ESCOLHA
AFIRME(total == 26, "ESCOLHA aninhada");
/* --------------------------------- SE / SENAO_SE / SENAO encadeados */
tests/run.sh · heredoc na linha 341
Contexto: C incorporado no runner (linha 341). Linhas: 351. Tipo de evidência: código; via ESCOLHA.
Linhas 349–353 · abrir contexto
REPITA
ATE 1;
ESCOLHA (1)
CASO 1:
CONTRARIO:
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.
ESCOLHA→ tests/casos/03_controle/c18_escolha_pare/programa.c, tests/casos/03_controle/c19_escolha_fallthrough/programa.c, tests/casos/03_controle/c20_escolha_bloco/programa.c, tests/casos/03_controle/c22_escolha_com_chamada/programa.c, tests/casos/03_controle/c35_escolha_no_laco/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
ESCOLHAe a forma canônicaBG_ESCOLHAsã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_ESCOLHA. As respostas repetem apenas o que o repositório mostra; quando não há evidência, isso é dito.
Em uma frase, o que BG_ESCOLHA faz?
Abre switch C para seleção por valores inteiros/enumerados.
Para que exatamente BG_ESCOLHA expande?
O pré-processador substitui BG_ESCOLHA pelo texto abaixo, sem criar função nem avaliar argumentos por conta própria.
Parâmetros formais: e.
switch (e) {
Como BG_ESCOLHA aparece em código real deste repositório?
Uso extraído de tests/casos/03_controle/c18_escolha_pare/programa.c:3, com as linhas vizinhas preservadas:
PROCEDIMENTO menu(INTEIRO opcao) {
ESCOLHA (opcao)
CASO 1:
ESCREVAL("novo");
Onde BG_ESCOLHA é exercitado nos testes?
Há 16 ocorrência(s) em 11 arquivo(s): tests/casos/03_controle/c18_escolha_pare/programa.c, tests/casos/03_controle/c19_escolha_fallthrough/programa.c, tests/casos/03_controle/c20_escolha_bloco/programa.c, tests/casos/03_controle/c22_escolha_com_chamada/programa.c, tests/casos/03_controle/c35_escolha_no_laco/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_ESCOLHA depende de compilador, padrão C ou sistema operacional?
BG_ESCOLHA 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_ESCOLHA?
O contrato editorial registra: “Sem PARE, a execução continua no próximo caso, como em C.”