Pular para o conteúdo principal

BG_RAIZ · RAIZ

Página gerada do fonte

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);
}

Ver no GitHub

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,

Ver no GitHub

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:

Ver no GitHub

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)

Ver no GitHub

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)

Ver no GitHub

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

Ver no GitHub

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"

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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"

Ver no GitHub

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"

Ver no GitHub

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

Ver no GitHub

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)

  • Requer libm no caminho GCC/Clang documentado.

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