bcsqrt

(PHP 4, PHP 5, PHP 7, PHP 8)

bcsqrtObtém a raiz quadrada de um número de precisão arbitrária

Descrição

bcsqrt(string $num, ?int $scale = null): string

Retorna a raiz quadrada do num.

Parâmetros

num

O operando, como uma string numérica no padrão BCMath.

scale

Este parâmetro opcional é usado para definir o número de dígitos após a casa decimal do resultado. Se omitido, o padrão será a escala definida globalmente com a função bcscale() ou, em último caso, 0 se a escala não tiver sido definida.

Valor Retornado

Retorna a raiz quadrada como uma string numérica no padrão BCMath.

Erros/Exceções

Esta função lança um ValueError nas seguintes situações:

  • num não é uma string numérica no padrão BCMath
  • num é menor que 0
  • scale está fora do range válido

Registro de Alterações

Versão Descrição
8.0.0 Se num não é uma string numérica no padrão BCMath, ou menor que 0, um ValueError é lançado. Anteriormente um E_WARNING era emitido.
8.0.0 scale now needs to be between 0 and 2147483647; previously, negative scales have been silently treated as 0.
8.0.0 scale is now nullable.

Exemplos

Example #1 Exemplo de bcsqrt()

<?php

echo bcsqrt('2', 3); // 1.414

?>

Veja Também

  • bcpow() - Eleva um número de precisão arbitrária a outro