BG_RAIZ · RAIZ
Gerada por tools/gerar_documentacao.py. Definição: include/basicgol.h:213.
Raiz quadrada via sqrt da libm.
Tipo: macro com argumentos · Módulo/categoria: Matemática.
Nomes equivalentes: RAIZ. Os testes de qualquer um desses nomes são reunidos nesta página.
Assinatura e expansão
#define BG_RAIZ(x) sqrt(x)
Parâmetros formais: x.
Corpo da macro:
sqrt(x)
Como funciona
Expande para sqrt(x). Argumento negativo segue o contrato de sqrt e pode sinalizar erro de domínio; não há verificação fatal própria do BASICGOL.
Exemplo de uso
REAL h = RAIZ(9.0);
Como este símbolo aparece nos testes
14 ocorrência(s) em 9 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/08_aplicacao/app_acervo/acervo.c
Contexto: app_acervo. Linhas: 121. Tipo de evidência: código; via RAIZ.
Linhas 119–123 · abrir contexto
soma = soma + POTENCIA(idade, 2);
}
RETORNE ARREDONDA(RAIZ(soma / total) * fator);
}
tests/fuzz_basicgolc.py
Contexto: fontes, fuzz_basicgolc.py, main. Linhas: 32, 49, 50, 51, 135, 168. Tipo de evidência: código; via RAIZ.
Linhas 30–34 · abrir contexto
from pathlib import Path
RAIZ = Path(__file__).resolve().parent.parent
# Entradas que estressam o léxico: chaves, literais, comentários, diretivas,
Linhas 47–53 · abrir contexto
def fontes() -> list[Path]:
"""Corpus: os fontes reais do repositório (casos + exemplos)."""
achados = sorted(RAIZ.glob("tests/casos/**/programa.c"))
achados += sorted(RAIZ.glob("tests/casos/**/*.c"))
achados += sorted(RAIZ.glob("docs/exemplos/*.c"))
vistos: dict[Path, None] = {}
for caminho in achados:
Linhas 133–137 · abrir contexto
ap = argparse.ArgumentParser(description=__doc__,
formatter_class=argparse.RawDescriptionHelpFormatter)
ap.add_argument("--basicgolc", default=str(RAIZ / "build" / "basicgolc"))
ap.add_argument("--iteracoes", type=int, default=300)
ap.add_argument("--seed", type=int, default=20261106)
Linhas 166–170 · abrir contexto
print(f" FALHA iteracao {n} ({nome}): rc={rc} {detalhe}")
(tmp / f"falha_{n}.c").write_bytes(dados)
destino = RAIZ / "build" / f"fuzz-falha-{n}.c"
destino.parent.mkdir(exist_ok=True)
destino.write_bytes(dados)
tests/portabilidade/fronteira.c
Contexto: fronteira.c. Linhas: 241. Tipo de evidência: código; via RAIZ.
Linhas 239–243 · abrir contexto
EXIGE(bg_round_l(1e15) == 1000000000000000LL);
EXIGE(ARREDONDA(2.5) == 3 E PISO(2.9) == 2.0 E TETO(2.1) == 3.0);
EXIGE(RAIZ(9.0) == 3.0 E POTENCIA(2.0, 10.0) == 1024.0);
/* -------------------------------------------------- caractere ASCII */
tests/run.sh
Contexto: run.sh. Linhas: 22. Tipo de evidência: código; via RAIZ.
Linhas 20–24 · abrir contexto
export LC_ALL=C
RAIZ=$(cd "$(dirname "$0")/.." && pwd)
T_CASOS="$RAIZ/tests/casos"
T_INCLUDE="$RAIZ/include"
tests/run_checkout_limpo.sh
Contexto: run_checkout_limpo.sh. Linhas: 23. Tipo de evidência: código; via RAIZ.
Linhas 21–25 · abrir contexto
set -u
RAIZ=$(cd "$(dirname "$0")/.." && pwd)
VERBOSO=0
[ "${1:-}" = "-v" ] && VERBOSO=1
tests/run_matriz.sh
Contexto: run_matriz.sh. Linhas: 18. Tipo de evidência: código; via RAIZ.
Linhas 16–20 · abrir contexto
set -u
RAIZ=$(cd "$(dirname "$0")/.." && pwd)
VERBOSO=0
[ "${1:-}" = "-v" ] && VERBOSO=1
tests/run_msvc.sh
Contexto: run_msvc.sh. Linhas: 27. Tipo de evidência: código; via RAIZ.
Linhas 25–29 · abrir contexto
export MSYS2_ARG_CONV_EXCL='*' MSYS_NO_PATHCONV=1
RAIZ=$(cd "$(dirname "$0")/.." && pwd)
cd "$RAIZ"
tests/run_portabilidade.sh
Contexto: run_portabilidade.sh. Linhas: 35. Tipo de evidência: código; via RAIZ.
Linhas 33–37 · abrir contexto
export LC_ALL=C
RAIZ=$(cd "$(dirname "$0")/.." && pwd)
PORT="$RAIZ/tests/portabilidade"
INCLUDE="$RAIZ/include"
tests/test_biblioteca.c
Contexto: testa_matematica. Linhas: 375. Tipo de evidência: código; via RAIZ.
Linhas 373–377 · abrir contexto
VERIFICA(MAXIMO(3, 9) == 9);
VERIFICA(fabs(POTENCIA(2.0, 10.0) - 1024.0) < 0.0001);
VERIFICA(RAIZ(144.0) == 12.0);
VERIFICA(ARREDONDA(-2.5) == -3LL);
VERIFICA(PISO(2.9) == 2.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.
RAIZ→ tests/casos/08_aplicacao/app_acervo/acervo.c, tests/fuzz_basicgolc.py, tests/portabilidade/fronteira.c, tests/run.sh, tests/run_checkout_limpo.sh …
Compiladores, padrão C e sistema operacional
Condições que envolvem a definição:
-
defined(BASICGOL_H)(fonte) -
Requer libm no caminho GCC/Clang documentado.
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
RAIZe a forma canônicaBG_RAIZsã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_RAIZ. As respostas repetem apenas o que o repositório mostra; quando não há evidência, isso é dito.
Em uma frase, o que BG_RAIZ faz?
Raiz quadrada via sqrt da libm.
Para que exatamente BG_RAIZ expande?
O pré-processador substitui BG_RAIZ pelo texto abaixo, sem criar função nem avaliar argumentos por conta própria.
Parâmetros formais: x.
sqrt(x)
Como usar BG_RAIZ em um programa?
Exemplo editorial mantido em tools/documentacao/contratos.json e conferido contra a assinatura real:
REAL h = RAIZ(9.0);
Onde BG_RAIZ é exercitado nos testes?
Há 14 ocorrência(s) em 9 arquivo(s): tests/casos/08_aplicacao/app_acervo/acervo.c, tests/fuzz_basicgolc.py, tests/portabilidade/fronteira.c, tests/run.sh, tests/run_checkout_limpo.sh …. 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_RAIZ depende de compilador, padrão C ou sistema operacional?
BG_RAIZ exige C11 como o restante da linguagem; largura de tipo, libc e CRT continuam sendo os do alvo.
Ressalvas registradas: Requer libm no caminho GCC/Clang documentado.
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.