BG_MOD · MOD
Gerada por tools/gerar_documentacao.py. Definição: include/basicgol.h:166.
Macro de objeto que expande para %. Reescrita tokenizada de operadores C. Precedência, conversões e efeitos colaterais seguem C, salvo proteção explícita mostrada na expansão.
Tipo: macro de objeto · Módulo/categoria: Operadores e lógica.
Nomes equivalentes: MOD. Os testes de qualquer um desses nomes são reunidos nesta página.
Assinatura e expansão
#define BG_MOD %
Corpo da macro:
%
Como funciona
Reescrita tokenizada de operadores C. Precedência, conversões e efeitos colaterais seguem C, salvo proteção explícita mostrada na expansão.
Como este símbolo aparece nos testes
21 ocorrência(s) em 13 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/b02_aritmetica/programa.c
Contexto: b02_aritmetica. Linhas: 8, 9, 12. Tipo de evidência: código; via MOD.
Linhas 6–14 · abrir contexto
ESCREVAL(7 / 2);
ESCREVAL(-7 / 2);
ESCREVAL(7 MOD 2);
ESCREVAL(-7 MOD 2);
ESCREVAL(2 + 3 * 4);
ESCREVAL((2 + 3) * 4);
ESCREVAL(10 MOD 10);
ESCREVAL(1 + 2 + 3 + 4 + 5);
FIM
tests/casos/03_controle/c02_se_senao/programa.c
Contexto: c02_se_senao. Linhas: 5. Tipo de evidência: código; via MOD.
Linhas 3–7 · abrir contexto
INICIO
INTEIRO x = 3;
SE x MOD 2 == 0 ENTAO
ESCREVAL("par");
SENAO
tests/casos/03_controle/c08_enquanto_prossiga/programa.c
Contexto: c08_enquanto_prossiga. Linhas: 10. Tipo de evidência: código; via MOD.
Linhas 8–12 · abrir contexto
ENQUANTO i < 10 FACA
i = i + 1;
SE i MOD 3 == 0 ENTAO
PROSSIGA;
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 MOD.
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/c28_aninhados_pare_prossiga/programa.c
Contexto: c28_aninhados_pare_prossiga. Linhas: 25. Tipo de evidência: código; via MOD.
Linhas 23–27 · abrir contexto
PARA (i, 1, 3) {
PARA (j, 1, 4) {
SE j MOD 2 == 0 ENTAO
PROSSIGA;
FIM_SE
tests/casos/03_controle/c30_repita_prossiga/programa.c
Contexto: c30_repita_prossiga. Linhas: 10. Tipo de evidência: código; via MOD.
Linhas 8–12 · abrir contexto
REPITA
i = i + 1;
SE i MOD 2 == 1 ENTAO
PROSSIGA;
FIM_SE
tests/casos/06_negativos/n07_mod_igual/programa.c
Contexto: n07_mod_igual. Linhas: 6. Tipo de evidência: código; via MOD.
Linhas 4–8 · abrir contexto
INICIO
INTEIRO x = 10;
x MOD= 3;
ESCREVAL(x);
FIM
tests/casos/06_negativos/n14_mod_com_real/programa.c
Contexto: n14_mod_com_real. Linhas: 5. Tipo de evidência: código; via MOD.
Linhas 3–7 · abrir contexto
INICIO
INTEIRO resto = 7 MOD 2.5;
ESCREVAL(resto);
FIM
tests/casos/07_multiarquivo/m01_modulos/matematica.c
Contexto: m01_modulos. Linhas: 26. Tipo de evidência: código; via MOD.
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/09_tipos_expr/t01_inteiros/programa.c
Contexto: t01_inteiros. Linhas: 37, 38, 39. Tipo de evidência: código; via MOD.
Linhas 35–41 · abrir contexto
ESCREVAL(7 / -2);
ESCREVAL(-8 / 2);
ESCREVAL(7 MOD 2);
ESCREVAL(-7 MOD 2);
ESCREVAL(7 MOD -2);
// --- natural estoura em módulo 2^N, o que C define (não é indefinido)
tests/casos/09_tipos_expr/t05_precedencia/programa.c
Contexto: t05_precedencia. Linhas: 10, 11. Tipo de evidência: código; via MOD.
Linhas 8–13 · abrir contexto
ESCREVAL(10 - 2 - 3); // 5 = (10-2)-3
ESCREVAL(100 / 10 / 2); // 5 = (100/10)/2
ESCREVAL(7 MOD 2 + 1); // 2 = (7%2)+1
ESCREVAL(1 + 2 * 3 MOD 4); // 3 = 1+((2*3)%4)
ESCREVAL(-7 / 2 + 1); // -2 = (-7/2)+1
ESCREVAL(2 + 3 < 6); // 1 = (2+3) < 6
tests/portabilidade/controle.c
Contexto: controle.c. Linhas: 185, 198. Tipo de evidência: código; via MOD.
Linhas 183–187 · abrir contexto
total = 0;
PARA (i, 0, 4) {
SE i MOD 2 == 0 ENTAO
PROSSIGA;
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: 35, 36, 38. Tipo de evidência: código; via MOD.
Linhas 33–40 · abrir contexto
AFIRME(a + b * c == 14, "a + b * c deve ser 14");
AFIRME((a + b) * c == 20, "(a + b) * c deve ser 20");
AFIRME(10 MOD 3 * 2 == 2, "10 MOD 3 * 2 deve ser 2 (MOD antes de *)");
AFIRME(2 + 10 MOD 3 == 3, "2 + 10 MOD 3 deve ser 3");
AFIRME(-7 / 2 == -3, "-7 / 2 trunca em direção a zero");
AFIRME(-7 MOD 2 == -1, "-7 MOD 2 tem o sinal do dividendo");
AFIRME(-2 * -3 == 6, "menos com menos");
AFIRME((!(a - b)) == 0, "operador C ! convive com NAO");
Também aparece na tabela de expansão conferida por cc -E -dM: L38.
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.
MOD→ tests/casos/02_basico/b02_aritmetica/programa.c, tests/casos/03_controle/c02_se_senao/programa.c, tests/casos/03_controle/c08_enquanto_prossiga/programa.c, tests/casos/03_controle/c21_laco_com_condicoes/programa.c, tests/casos/03_controle/c28_aninhados_pare_prossiga/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
MODe a forma canônicaBG_MODsã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_MOD. As respostas repetem apenas o que o repositório mostra; quando não há evidência, isso é dito.
Em uma frase, o que BG_MOD faz?
Macro de objeto que expande para %. Reescrita tokenizada de operadores C. Precedência, conversões e efeitos colaterais seguem C, salvo proteção explícita mostrada na expansão.
Para que exatamente BG_MOD expande?
O pré-processador substitui BG_MOD pelo texto abaixo, sem criar função nem avaliar argumentos por conta própria.
%
Como BG_MOD aparece em código real deste repositório?
Uso extraído de tests/casos/02_basico/b02_aritmetica/programa.c:6, com as linhas vizinhas preservadas:
ESCREVAL(7 / 2);
ESCREVAL(-7 / 2);
ESCREVAL(7 MOD 2);
ESCREVAL(-7 MOD 2);
ESCREVAL(2 + 3 * 4);
Onde BG_MOD é exercitado nos testes?
Há 21 ocorrência(s) em 13 arquivo(s): tests/casos/02_basico/b02_aritmetica/programa.c, tests/casos/03_controle/c02_se_senao/programa.c, tests/casos/03_controle/c08_enquanto_prossiga/programa.c, tests/casos/03_controle/c21_laco_com_condicoes/programa.c, tests/casos/03_controle/c28_aninhados_pare_prossiga/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_MOD depende de compilador, padrão C ou sistema operacional?
BG_MOD 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.