Pular para o conteúdo principal

BG_MOD · MOD

Página gerada do fonte

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

Ver no GitHub

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

Ver no GitHub

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

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

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/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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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)

Ver no GitHub

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

Ver no GitHub

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

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

Ver no GitHub

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.

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 MOD e a forma canônica BG_MOD 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_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.