Pular para o conteúdo principal

BG_ESCOLHA · ESCOLHA

Página gerada do fonte

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.

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

Ver no GitHub

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

Ver no GitHub

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;

Ver no GitHub

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

Ver no GitHub

Linhas 14–18 · abrir contexto
FIM_ESCOLHA

ESCOLHA (soma(2, 2) * 2)
CASO 8:
ESCREVAL("oito");

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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;

Ver no GitHub

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

Ver no GitHub

Linhas 115–119 · abrir contexto

total = 0;
ESCOLHA (soma(1, 2)) /* vírgula de nível superior em macro */
CASO 3:
total = 30;

Ver no GitHub

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;

Ver no GitHub

Linhas 140–144 · abrir contexto
total = 0;
FIM_ESCOLHA
AFIRME(total == 26, "ESCOLHA aninhada");

/* --------------------------------- SE / SENAO_SE / SENAO encadeados */

Ver no GitHub

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:

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