bg_max_i
Gerada por tools/gerar_documentacao.py. Definição: src/biblioteca/matematica.c:226.
Variante tipada de máximo usada por MAXIMO.
Tipo: função C · Visibilidade: pública · Arquivo: src/biblioteca/matematica.c.
Assinatura e expansão
int bg_max_i(int a, int b)
Parâmetros formais: int a, int b.
Declarações públicas localizadas:
Como funciona
Compara os dois argumentos uma vez. As variantes inteiras usam operador relacional; a variante double usa fmax da libm.
Exemplo de uso
INTEIRO maior = MAXIMO(7, 3);
Implementação
{
return (a > b) ? a : b;
}
Interface BASICGOL relacionada
Como este símbolo aparece nos testes
2 ocorrência(s) em 2 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/portabilidade/fronteira.c
Contexto: fronteira.c. Linhas: 227. Tipo de evidência: código; via bg_max_i.
Linhas 225–229 · abrir contexto
EXIGE(bg_abs_d(-2.5) == 2.5);
EXIGE(bg_min_i(1, 2) == 1 E bg_min_i(2, 1) == 1 E bg_min_i(3, 3) == 3);
EXIGE(bg_max_i(1, 2) == 2 E bg_max_i(2, 1) == 2 E bg_max_i(3, 3) == 3);
EXIGE(bg_min_l(-1L, 1L) == -1L E bg_max_l(-1L, 1L) == 1L);
EXIGE(bg_min_d(-1.0, 1.0) == -1.0 E bg_max_d(-1.0, 1.0) == 1.0);
tests/test_biblioteca.c
Contexto: testa_matematica. Linhas: 365. Tipo de evidência: código; via bg_max_i.
Linhas 363–367 · abrir contexto
VERIFICA(bg_min_l(3L, 9L) == 3L);
VERIFICA(bg_min_d(3.0, 9.0) == 3.0);
VERIFICA(bg_max_i(3, 9) == 9);
VERIFICA(bg_max_l(3L, 9L) == 9L);
VERIFICA(bg_max_d(3.0, 9.0) == 9.0);
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.
BG_MAXIMO→ tests/casos/08_aplicacao/app_acervo/relatorio.c, tests/casos/09_tipos_expr/t02_reais/programa.c, tests/portabilidade/fronteira.c, tests/portabilidade/precedencia.c, tests/test_biblioteca.c
Compiladores, padrão C e sistema operacional
Nenhum ramo condicional externo foi detectado para este símbolo. A implementação é compartilhada no fonte; isso não certifica compiladores ou sistemas não executados.
- NaN e zeros com sinal na variante double seguem fmax da libm.
- Limites de tipos vêm do alvo. Funções libm exigem -lm no caminho GCC/Clang documentado; o CRT do MSVC não usa essa flag.
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. - Declare pelo cabeçalho (
include/basicgol/matematica.h) e liguebuild/libbasicgol.a; não copie o corpo desrc/biblioteca/matematica.cpara o seu arquivo. - Ligue também
-lmno caminho GCC/Clang; o CRT do MSVC não usa essa flag. - 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_max_i. As respostas repetem apenas o que o repositório mostra; quando não há evidência, isso é dito.
Em uma frase, o que bg_max_i faz?
Variante tipada de máximo usada por MAXIMO.
Qual é a assinatura e o tipo de retorno de bg_max_i?
Assinatura extraída de src/biblioteca/matematica.c; visibilidade pública.
int bg_max_i(int a, int b)
Como usar bg_max_i em um programa?
Exemplo editorial mantido em tools/documentacao/contratos.json e conferido contra a assinatura real:
INTEIRO maior = MAXIMO(7, 3);
Onde bg_max_i é exercitado nos testes?
Há 2 ocorrência(s) em 2 arquivo(s): tests/portabilidade/fronteira.c, tests/test_biblioteca.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_max_i depende de compilador, padrão C ou sistema operacional?
bg_max_i exige C11 como o restante da linguagem; largura de tipo, libc e CRT continuam sendo os do alvo.
Ressalvas registradas: NaN e zeros com sinal na variante double seguem fmax da libm.
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.