Pular para o conteúdo principal

BG_CASO · CASO

Página gerada do fonte

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

Introduz um rótulo case dentro de ESCOLHA.

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

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

Assinatura e expansão​

#define BG_CASO case

Corpo da macro:

case

Como funciona​

Expande para case; requer valor constante e dois-pontos.

Como este símbolo aparece nos testes​

19 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: 6. Tipo de evidência: código; via CASO.

Linhas 4–8 · abrir contexto
PROCEDIMENTO menu(INTEIRO opcao) {
ESCOLHA (opcao)
CASO 1:
ESCREVAL("novo");
PARE;

Ver no GitHub

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

Contexto: c19_escolha_fallthrough. Linhas: 23, 26. Tipo de evidência: código; via CASO.

Linhas 21–28 · abrir contexto
ESCREVA("um ");
cai_para_proximo;
CASO 2:
ESCREVA("dois ");
cai_para_proximo;
CASO 3:
ESCREVA("tres ");
PARE;

Ver no GitHub

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

Contexto: c20_escolha_bloco. Linhas: 7. Tipo de evidência: código; via CASO.

Linhas 5–9 · abrir contexto
INICIO
ESCOLHA (3)
CASO 3: {
INTEIRO quadrado = 3 * 3;
ESCREVAL(quadrado);

Ver no GitHub

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

Contexto: c22_escolha_com_chamada. Linhas: 17. Tipo de evidência: código; via CASO.

Linhas 15–19 · abrir contexto

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

Ver no GitHub

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

Contexto: c35_escolha_no_laco. Linhas: 11. Tipo de evidência: código; via CASO.

Linhas 9–13 · abrir contexto
PARA (i, 0, 5) {
ESCOLHA (i)
CASO 0:
PROSSIGA; // i = 0: pula o +1000 abaixo
CASO 1:

Ver no GitHub

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

Contexto: e07_enumeracao. Linhas: 12. Tipo de evidência: código; via CASO.

Linhas 10–14 · abrir contexto
FUNCAO TEXTO nome_da(Cor c) {
ESCOLHA (c)
CASO VERMELHO:
RETORNE "vermelho";
CASO VERDE:

Ver no GitHub

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

Contexto: n20_escolha_com_virgula. Linhas: 8. Tipo de evidência: código; via CASO.

Linhas 6–10 · abrir contexto
INTEIRO b = 2;
ESCOLHA (a, b)
CASO 1:
ESCREVAL("um");
PARE;

Ver no GitHub

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

Contexto: app_acervo. Linhas: 126. Tipo de evidência: código; via CASO.

Linhas 124–128 · abrir contexto
FUNCAO TEXTO nome_situacao(Situacao s) {
ESCOLHA (s)
CASO DISPONIVEL:
RETORNE "disponivel";
CASO EMPRESTADO:

Ver no GitHub

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

Contexto: app_acervo. Linhas: 72, 75, 78, 95. Tipo de evidência: código; via CASO.

Linhas 70–80 · abrir contexto

ESCOLHA (comando[0])
CASO 'f':
sair = VERDADEIRO;
PARE;
CASO 'r':
relatorio(fator);
PARE;
CASO 'e':
SE id < 0 ENTAO
ESCREVA_ERRO("falta o id do livro\n");

Ver no GitHub

Linhas 93–97 · abrir contexto
FIM_SE
PARE;
CASO 'd':
SE devolve(id) ENTAO
ESCREVA_FMT("devolvido: %d\n", id);

Ver no GitHub

tests/portabilidade/controle.c​

Contexto: controle.c. Linhas: 102, 106, 118, 129, 131. Tipo de evidência: código; via CASO.

Linhas 100–108 · abrir contexto
PARA (i, 1, 3) {
ESCOLHA (i)
CASO 1:
SE VERDADEIRO ENTAO
PARE; /* sai do ESCOLHA, não do PARA */
FIM_SE
CASO 2:
total = total + 2;
PARE;

Ver no GitHub

Linhas 116–120 · abrir contexto
total = 0;
ESCOLHA (soma(1, 2)) /* vírgula de nível superior em macro */
CASO 3:
total = 30;
PARE;

Ver no GitHub

Linhas 127–133 · abrir contexto
total = 0;
ESCOLHA (2)
CASO 2:
ESCOLHA (5)
CASO 5:
total = 25;
PARE;

Ver no GitHub

tests/run.sh · heredoc na linha 341​

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

Linhas 350–354 · abrir contexto
ATE 1;
ESCOLHA (1)
CASO 1:
CONTRARIO:
FIM_ESCOLHA

Ver no GitHub

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

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

Em uma frase, o que BG_CASO faz?​

Introduz um rótulo case dentro de ESCOLHA.

Para que exatamente BG_CASO expande?​

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

case

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

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

PROCEDIMENTO menu(INTEIRO opcao) {
ESCOLHA (opcao)
CASO 1:
ESCREVAL("novo");
PARE;

Onde BG_CASO é exercitado nos testes?​

Há 19 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_CASO depende de compilador, padrão C ou sistema operacional?​

BG_CASO 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.