Pular para o conteúdo principal

BG_SE · SE

Página gerada do fonte

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

Abre um condicional if de C; a condição é fechada por ENTAO.

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

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

Assinatura e expansão​

#define BG_SE if (

Corpo da macro:

if (

Como funciona​

Expande para if ( e ENTAO para ) {. SENAO_SE, SENAO e FIM_SE completam a cadeia. O bloco tem escopo C normal.

Contrato e armadilhas
  • Use SENAO_SE, não SENAO SE.
  • Não misture chaves de abertura C com FIM_SE no mesmo construtor.

Exemplo de uso​

SE idade >= 18 ENTAO
ESCREVAL("maior de idade");
SENAO
ESCREVAL("menor de idade");
FIM_SE

Comentário do fonte​

--- controle ---

Como este símbolo aparece nos testes​

67 ocorrência(s) em 35 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/02_basico/b03_real/programa.c​

Contexto: b03_real. Linhas: 27. Tipo de evidência: código; via SE.

Linhas 25–29 · abrir contexto
/* On x87, excess precision can make this comparison equal. C permits
* that implementation-defined evaluation, so record both outcomes. */
SE 0.1 + 0.2 == 0.3 ENTAO
ESCREVAL("igualdade exata (precisao excedente)");
SENAO

Ver no GitHub

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

Contexto: c01_se_simples. Linhas: 8. Tipo de evidência: código; via SE.

Linhas 6–10 · abrir contexto
ESCREVAL("maior");
FIM_SE
SE x > 50 ENTAO
ESCREVAL("nunca");
FIM_SE

Ver no GitHub

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

Contexto: c04_aninhado. Linhas: 11, 12. Tipo de evidência: código; via SE.

Linhas 9–14 · abrir contexto

SE a == 1 ENTAO
SE b == 2 ENTAO
SE c == 3 ENTAO
ESCREVAL("tres niveis");
SENAO

Ver no GitHub

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

Contexto: c05_se_vazio. Linhas: 6, 8. Tipo de evidência: código; via SE.

Linhas 4–10 · abrir contexto

INICIO
SE 1 ENTAO
FIM_SE
SE 0 ENTAO
SENAO
FIM_SE

Ver no GitHub

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

Contexto: c21_laco_com_condicoes. Linhas: 13. Tipo de evidência: código; via SE.

Linhas 11–15 · abrir contexto
PARE;
FIM_SE
SE i MOD 7 == 0 E i > 10 ENTAO
achados = achados + 1;
FIM_SE

Ver no GitHub

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

Contexto: c33_condicoes_aninhadas. Linhas: 12. Tipo de evidência: código; via SE.

Linhas 10–14 · abrir contexto
PARA (b, 0, 1) {
SE a == 1 ENTAO
SE b == 1 ENTAO
ESCREVAL("a e b");
SENAO

Ver no GitHub

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

Contexto: c36_laco_entrada_sentinela. Linhas: 18, 22, 25, 45, 50. Tipo de evidência: código; via SE.

Linhas 16–27 · abrir contexto
ENQUANTO valor != 0 FACA
// primeiro valor inicializa máximo e mínimo; os demais só os atualizam
SE qtd == 0 ENTAO
maximo = valor;
minimo = valor;
FIM_SE
SE valor > maximo ENTAO
maximo = valor;
FIM_SE
SE valor < minimo ENTAO
minimo = valor;
FIM_SE

Ver no GitHub

Linhas 43–52 · abrir contexto
ESCREVAL("Rodada 2");
qtd = 0;
SE NAO LEIA_INTEIRO(valor) ENTAO
ERRO("entrada invalida");
FIM_SE
ENQUANTO valor != 0 FACA
qtd = qtd + 1;
SE NAO LEIA_INTEIRO(valor) ENTAO
ERRO("entrada invalida");
FIM_SE

Ver no GitHub

tests/casos/05_entrada_saida/i04_leia_tipos/programa.c​

Contexto: i04_leia_tipos. Linhas: 13, 16. Tipo de evidência: código; via SE.

Linhas 11–18 · abrir contexto
ESCREVAL(n);
FIM_SE
SE LEIA_OK(r) ENTAO
ESCREVA_FMT("real %.2f\n", r);
FIM_SE
SE LEIA_OK(c) ENTAO
ESCREVA("char ");
ESCREVAL(c);

Ver no GitHub

tests/casos/05_entrada_saida/i06_leia_texto_apos_leia/programa.c​

Contexto: i06_leia_texto_apos_leia. Linhas: 13. Tipo de evidência: código; via SE.

Linhas 11–15 · abrir contexto
ESCREVAL(idade);
FIM_SE
SE LEIA_TEXTO(nome, (INTEIRO) sizeof nome) ENTAO
ESCREVA("nome [");
ESCREVA_TEXTO(nome);

Ver no GitHub

tests/casos/05_entrada_saida/i08_leia_texto_truncamento/programa.c​

Contexto: i08_leia_texto_truncamento. Linhas: 15. Tipo de evidência: código; via SE.

Linhas 13–17 · abrir contexto
FIM_SE

SE LEIA_TEXTO(depois, (INTEIRO) sizeof depois) ENTAO
ESCREVA("proxima [");
ESCREVA_TEXTO(depois);

Ver no GitHub

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

Contexto: n01_se_sem_fim_se. Linhas: 5. Tipo de evidência: código; via SE.

Linhas 3–7 · abrir contexto
// o bloco SE nao foi fechado
INICIO
SE 1 ENTAO
ESCREVAL("x");
FIM

Ver no GitHub

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

Contexto: n02_se_com_chaves_c. Linhas: 5. Tipo de evidência: código; via SE.

Linhas 3–7 · abrir contexto
// chaves de C no cabecalho do SE: o C ve "if ((1) {"
INICIO
SE (1) {
ESCREVAL("x");
}

Ver no GitHub

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

Contexto: n03_senao_se. Linhas: 5, 7. Tipo de evidência: código; via SE.

Linhas 3–9 · abrir contexto
// "SENAO SE" nao encadeia: o C ve "} else { if (...) { ... }" e fica um '{' aberto
INICIO
SE 1 ENTAO
ESCREVAL("a");
SENAO SE 2 ENTAO
ESCREVAL("b");
FIM_SE

Ver no GitHub

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

Contexto: n08_variavel_com_nome_de_palavra. Linhas: 5, 6. Tipo de evidência: código; via SE.

Linhas 3–7 · abrir contexto
// palavras-chave viram macros: nao servem como nome de variavel
INICIO
INTEIRO SE = 1;
ESCREVAL(SE);
FIM

Ver no GitHub

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

Contexto: n10_falta_entao. Linhas: 5. Tipo de evidência: código; via SE.

Linhas 3–7 · abrir contexto
// SE exige ENTAO antes do bloco
INICIO
SE 1
ESCREVAL("sem entao");
FIM_SE

Ver no GitHub

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

Contexto: n18_prossiga_fora_de_laco. Linhas: 5. Tipo de evidência: código; via SE.

Linhas 3–7 · abrir contexto
// PROSSIGA sem laço envolvente: o C não tem para onde saltar
INICIO
SE 1 ENTAO
PROSSIGA;
FIM_SE

Ver no GitHub

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

Contexto: m01_modulos. Linhas: 26. Tipo de evidência: código; via SE.

Linhas 24–28 · abrir contexto
INTEIRO d = 2;
ENQUANTO d * d <= n FACA
SE IGUAL(n MOD d, 0) ENTAO
RETORNE FALSO;
FIM_SE

Ver no GitHub

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

Contexto: app_acervo. Linhas: 16, 27, 40, 52, 66, 74, 89. Tipo de evidência: código; via SE.

Linhas 14–18 · abrir contexto
ERRO("titulo longo demais");
FIM_SE
SE NAO COPIA_TEXTO(acervo[total].autor, AUTOR_MAX, autor) ENTAO
ERRO("autor longo demais");
FIM_SE

Ver no GitHub

Linhas 25–29 · abrir contexto
INTEIRO i = 0;
ENQUANTO i < total FACA
SE IGUAL(acervo[i].id, id) ENTAO
RETORNE i;
FIM_SE

Ver no GitHub

Linhas 38–42 · abrir contexto
RETORNE FALSO;
FIM_SE
SE IGUAL(acervo[pos].situacao, EMPRESTADO) ENTAO
RETORNE FALSO;
FIM_SE

Ver no GitHub

Linhas 50–54 · abrir contexto
RETORNE FALSO;
FIM_SE
SE IGUAL(acervo[pos].situacao, DISPONIVEL) ENTAO
RETORNE FALSO;
FIM_SE

Ver no GitHub

Linhas 64–68 · abrir contexto
LOGICO trocou = FALSO;
ENQUANTO j + 1 < total - i FACA
SE acervo[j].ano > acervo[j + 1].ano ENTAO
Livro tmp = acervo[j];
acervo[j] = acervo[j + 1];

Ver no GitHub

Linhas 72–76 · abrir contexto
j = j + 1;
FIM_ENQUANTO
SE NAO trocou ENTAO
PARE;
FIM_SE

Ver no GitHub

1 outros blocos de contexto: use os links de linha e o JSON de inventário.

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

Contexto: app_acervo. Linhas: 11, 12, 40, 45, 48, 62, 65, 79. Tipo de evidência: código; via SE.

Linhas 9–14 · abrir contexto
INTEIRO valor = -1;
ENQUANTO i < TAMANHO_TEXTO(s) FACA
SE s[i] >= '0' E s[i] <= '9' ENTAO
SE valor < 0 ENTAO
valor = 0;
FIM_SE

Ver no GitHub

Linhas 38–50 · abrir contexto
ERRO("entrada vazia: faltou a cota de emprestimos");
FIM_SE
SE NAO TEXTO_PARA_INTEIRO(linha, &quota) ENTAO
ERRO("cota invalida: esperado um inteiro na primeira linha");
FIM_SE

// 2ª linha: fator de raridade (real)
SE NAO LEIA_TEXTO(linha, 64) ENTAO
ERRO("faltou o fator de raridade");
FIM_SE
SE NAO TEXTO_PARA_REAL(linha, &fator) ENTAO
ERRO("fator invalido: esperado um real na segunda linha");
FIM_SE

Ver no GitHub

Linhas 60–67 · abrir contexto

REPITA
SE NAO LEIA_TEXTO(comando, 64) ENTAO
PARE; // fim da entrada
FIM_SE
SE IGUAL(TAMANHO_TEXTO(comando), 0) ENTAO
PROSSIGA; // linha em branco
FIM_SE

Ver no GitHub

Linhas 77–81 · abrir contexto
PARE;
CASO 'e':
SE id < 0 ENTAO
ESCREVA_ERRO("falta o id do livro\n");
recusados = recusados + 1;

Ver no GitHub

tests/casos/09_tipos_expr/t04_logico/programa.c​

Contexto: t04_logico. Linhas: 32. Tipo de evidência: código; via SE.

Linhas 30–34 · abrir contexto
ESCREVAL("nao deveria");
FIM_SE
SE v OU (++n > 0) ENTAO
ESCREVAL("curto-circuito ok");
FIM_SE

Ver no GitHub

tests/casos/09_tipos_expr/t12_leia_numeros/programa.c​

Contexto: t12_leia_numeros. Linhas: 15, 21, 27, 33, 39, 45. Tipo de evidência: código; via SE.

Linhas 13–17 · abrir contexto

// a linha inválida é consumida: a próxima leitura começa na linha seguinte
SE LEIA_INTEIRO(n) ENTAO
ESCREVAL(n);
SENAO

Ver no GitHub

Linhas 19–23 · abrir contexto
FIM_SE

SE LEIA_INTEIRO(n) ENTAO
ESCREVAL(n);
SENAO

Ver no GitHub

Linhas 25–29 · abrir contexto
FIM_SE

SE LEIA_REAL(r) ENTAO
ESCREVA_FMT("%.1f\n", r);
SENAO

Ver no GitHub

Linhas 31–35 · abrir contexto
FIM_SE

SE LEIA_REAL(r) ENTAO // "2,5": locale C recusa a vírgula
ESCREVA_FMT("%.1f\n", r);
SENAO

Ver no GitHub

Linhas 37–41 · abrir contexto
FIM_SE

SE LEIA_REAL(r) ENTAO // "1e999": estouro de faixa
ESCREVA_FMT("%.1f\n", r);
SENAO

Ver no GitHub

Linhas 43–47 · abrir contexto
FIM_SE

SE LEIA_INTEIRO(n) ENTAO
ESCREVAL(n);
SENAO

Ver no GitHub

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

Contexto: t01_se_com_chaves. Linhas: 4. Tipo de evidência: código; via SE.

Linhas 2–6 · abrir contexto

INICIO
SE (1) {
ESCREVAL("x");
}

Ver no GitHub

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

Contexto: t02_senao_se. Linhas: 4, 6. Tipo de evidência: código; via SE.

Linhas 2–8 · abrir contexto

INICIO
SE 1 ENTAO
ESCREVAL("a");
SENAO SE 2 ENTAO
ESCREVAL("b");
FIM_SE

Ver no GitHub

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

Contexto: t03_bloco_sem_fim. Linhas: 4. Tipo de evidência: código; via SE.

Linhas 2–6 · abrir contexto

INICIO
SE 1 ENTAO
ESCREVAL("a");
FIM

Ver no GitHub

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

Contexto: t08_par_unico. Linhas: 4. Tipo de evidência: código; via SE.

Linhas 2–6 · abrir contexto

INICIO
SE 1 ENTAO
ESCREVAL("a");
FIM_SE

Ver no GitHub

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

Contexto: w03_condicao_literal. Linhas: 5. Tipo de evidência: código; via SE.

Linhas 3–7 · abrir contexto
// W-03: condicao inteira literal (em C, != 0 e verdadeiro)
INICIO
SE 1 ENTAO
ESCREVAL("sempre");
FIM_SE

Ver no GitHub

tests/portabilidade/cabecalhos_tu3.c​

Contexto: cabecalhos_tu3.c. Linhas: 11. Tipo de evidência: condicional; via SE.

Linhas 9–13 · abrir contexto
#include <basicgol.h>

#ifdef SE
# error "nome curto SE nao deveria existir com BG_SEM_APELIDOS"
#endif

Ver no GitHub

tests/portabilidade/controle.c​

Contexto: controle.c. Linhas: 103, 146, 158, 160, 198. Tipo de evidência: código; via SE.

Linhas 101–105 · abrir contexto
ESCOLHA (i)
CASO 1:
SE VERDADEIRO ENTAO
PARE; /* sai do ESCOLHA, não do PARA */
FIM_SE

Ver no GitHub

Linhas 144–148 · abrir contexto
/* --------------------------------- SE / SENAO_SE / SENAO encadeados */
total = 0;
SE 1 == 2 ENTAO
total = 10;
SENAO_SE 2 == 2 ENTAO

Ver no GitHub

Linhas 156–162 · abrir contexto

total = 0;
SE 1 == 2 ENTAO
FIM_SE /* bloco vazio */
SE VERDADEIRO ENTAO
total = 1;
FIM_SE

Ver no GitHub

Linhas 196–200 · abrir contexto
j = 0;
ENQUANTO j < 3 FACA
SE (i + j) MOD 3 == 0 ENTAO
total = total + 1;
SENAO

Ver no GitHub

tests/portabilidade/precedencia.c​

Contexto: precedencia.c. Linhas: 78. Tipo de evidência: código; via SE.

Linhas 76–80 · abrir contexto
ESCREVAL("nunca");
FIM_SE
SE VERDADEIRO OU sempre_verdadeiro() ENTAO
ESCREVAL("");
FIM_SE

Ver no GitHub

tests/run.sh​

Contexto: run.sh. Linhas: 161. Tipo de evidência: código; via BG_SE.

Linhas 159–163 · abrir contexto
BG_INICIO
BG_ESCREVAL("prefixado ok");
BG_SE 1 BG_ENTAO
BG_ESCREVAL("se ok");
BG_FIM_SE

Ver no GitHub

tests/run.sh · heredoc na linha 174​

Contexto: C incorporado no runner (linha 174). Linhas: 176. Tipo de evidência: condicional; via SE.

Linhas 174–178 · abrir contexto
#define BG_SEM_APELIDOS
#include <basicgol.h>
#ifdef SE
#error "nome curto SE nao deveria existir"
#endif

Ver no GitHub

tests/run.sh · heredoc na linha 341​

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

Linhas 341–345 · abrir contexto
#include <basicgol.h>
INICIO
SE 1 ENTAO
SENAO_SE 2 ENTAO
SENAO

Ver no GitHub

tests/run.sh · heredoc na linha 410​

Contexto: C incorporado no runner (linha 410). Linhas: 412. Tipo de evidência: código; via SE.

Linhas 410–414 · abrir contexto
#include <basicgol.h>
INICIO
SE 1 ENTAO
FIM_SE
ENQUANTO 0 FACA

Ver no GitHub

tests/run.sh · heredoc na linha 423​

Contexto: C incorporado no runner (linha 423). Linhas: 425. Tipo de evidência: código; via SE.

Linhas 423–426 · abrir contexto
#include <basicgol.h>
INICIO
SE 1 ENTAO
ESCREVAL("sem fim");

Ver no GitHub

tests/run_portabilidade.sh​

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

Linhas 184–188 · abrir contexto

/* uso real: uma macro de cada família, para o compilador analisar de verdade */
INICIO
INTEIRO i = 0;
LOGICO b = VERDADEIRO;

Ver no GitHub

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

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

Em uma frase, o que BG_SE faz?​

Abre um condicional if de C; a condição é fechada por ENTAO.

Para que exatamente BG_SE expande?​

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

if (

Como usar BG_SE em um programa?​

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

SE idade >= 18 ENTAO
ESCREVAL("maior de idade");
SENAO
ESCREVAL("menor de idade");
FIM_SE

Onde BG_SE é exercitado nos testes?​

Há 67 ocorrência(s) em 35 arquivo(s): tests/casos/02_basico/b03_real/programa.c, tests/casos/03_controle/c01_se_simples/programa.c, tests/casos/03_controle/c04_aninhado/programa.c, tests/casos/03_controle/c05_se_vazio/programa.c, tests/casos/03_controle/c21_laco_com_condicoes/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_SE depende de compilador, padrão C ou sistema operacional?​

BG_SE 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_SE?​

O contrato editorial registra: “Use SENAO_SE, não SENAO SE.” “Não misture chaves de abertura C com FIM_SE no mesmo construtor.”