BG_SE · SE
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.
- 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
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
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
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
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
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
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
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
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);
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);
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);
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
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");
}
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
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
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
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
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
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
Linhas 25–29 · abrir contexto
INTEIRO i = 0;
ENQUANTO i < total FACA
SE IGUAL(acervo[i].id, id) ENTAO
RETORNE i;
FIM_SE
Linhas 38–42 · abrir contexto
RETORNE FALSO;
FIM_SE
SE IGUAL(acervo[pos].situacao, EMPRESTADO) ENTAO
RETORNE FALSO;
FIM_SE
Linhas 50–54 · abrir contexto
RETORNE FALSO;
FIM_SE
SE IGUAL(acervo[pos].situacao, DISPONIVEL) ENTAO
RETORNE FALSO;
FIM_SE
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];
Linhas 72–76 · abrir contexto
j = j + 1;
FIM_ENQUANTO
SE NAO trocou ENTAO
PARE;
FIM_SE
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
Linhas 38–50 · abrir contexto
ERRO("entrada vazia: faltou a cota de emprestimos");
FIM_SE
SE NAO TEXTO_PARA_INTEIRO(linha, "a) 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
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
Linhas 77–81 · abrir contexto
PARE;
CASO 'e':
SE id < 0 ENTAO
ESCREVA_ERRO("falta o id do livro\n");
recusados = recusados + 1;
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
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
Linhas 19–23 · abrir contexto
FIM_SE
SE LEIA_INTEIRO(n) ENTAO
ESCREVAL(n);
SENAO
Linhas 25–29 · abrir contexto
FIM_SE
SE LEIA_REAL(r) ENTAO
ESCREVA_FMT("%.1f\n", r);
SENAO
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
Linhas 37–41 · abrir contexto
FIM_SE
SE LEIA_REAL(r) ENTAO // "1e999": estouro de faixa
ESCREVA_FMT("%.1f\n", r);
SENAO
Linhas 43–47 · abrir contexto
FIM_SE
SE LEIA_INTEIRO(n) ENTAO
ESCREVAL(n);
SENAO
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");
}
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
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
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
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
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
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
Linhas 144–148 · abrir contexto
/* --------------------------------- SE / SENAO_SE / SENAO encadeados */
total = 0;
SE 1 == 2 ENTAO
total = 10;
SENAO_SE 2 == 2 ENTAO
Linhas 156–162 · abrir contexto
total = 0;
SE 1 == 2 ENTAO
FIM_SE /* bloco vazio */
SE VERDADEIRO ENTAO
total = 1;
FIM_SE
Linhas 196–200 · abrir contexto
j = 0;
ENQUANTO j < 3 FACA
SE (i + j) MOD 3 == 0 ENTAO
total = total + 1;
SENAO
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
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
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
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
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
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");
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;
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.
SE→ 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 …
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
SEe a forma canônicaBG_SEsã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_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.”