PHP 8.4.2 Released!

    bcpow

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

    bcpow — Raise an arbitrary precision number to another

    Опис

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

    Raise num to the power exponent.

    Параметри

    num

    The base, as a string.

    exponent

    The exponent, as a string. Must be a value with no fractional part. The valid range of the exponent is platform specific, but is at least -2147483648 to 2147483647.

    scale

    Необов'язковий параметр, яким вказується кількість знаків після крапки в результаті. Якщо опущено, застосовується межа, що встановлена глобально функцією bcscale(), або ж 0, якщо межа ще не встановлена.

    Значення, що повертаються

    Returns the result as a string.

    Помилки/виключення

    This function throws a ValueError in the following cases:

    • num or exponent is not a well-formed BCMath numeric string
    • exponent has a fractional part
    • exponent or scale is outside the valid range

    This function throws a DivisionByZeroError exception if num is 0 and exponent is a negative value.

    Журнал змін

    Версія Опис
    8.4.0 Negative powers of 0 previously returned 0, but now throw a DivisionByZeroError exception.
    8.0.0 When exponent has a fractional part, it now throws a ValueError instead of truncating.
    7.3.0 bcpow() now returns numbers with the requested scale. Formerly, the returned numbers may have omitted trailing decimal zeroes.

    Приклади

    Приклад #1 bcpow() example

    <?php

    echo bcpow('4.2', '3', 2); // 74.08

    ?>

    Примітки

    Зауваження:

    Before PHP 7.3.0 bcpow() may return a result with fewer digits after the decimal point than the scale parameter would indicate. This only occurs when the result doesn't require all of the precision allowed by the scale. For example:

    Приклад #2 bcpow() scale example

    <?php
    echo bcpow('5', '2', 2); // prints "25", not "25.00"
    ?>

    Прогляньте також

    • bcpowmod() - Raise an arbitrary precision number to another, reduced by a specified modulus
    • bcsqrt() - Get the square root of an arbitrary precision number

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 3 notes

    up
    -1
    thomas at tgohome dot com
    15 years ago
    <?php

    bcscale    (100);

    /*
    * Computes the natural logarithm using a series.
    * @author Thomas Oldbury.
    * @license Public domain.
    */
    function bcln($a, $iter = 10)
    {
    $result = "0.0";

    for(    $i = 0; $i < $iter; $i++)
    {
    $pow = (1 + (2 * $i));
    $mul = bcdiv("1.0", $pow);
    $fraction = bcmul($mul, bcpow(bcsub($a, "1.0") / bcadd($a, "1.0"), $pow));
    $result = bcadd($fraction, $result);
    }

    return     bcmul("2.0", $result);
    }

    /*
    * Computes the base2 log using baseN log.
    * @note Requires above functions.
    * @author Thomas Oldbury.
    * @license Public domain.
    */
    function bclog2($a, $iter = 10)
    {
    return     bcdiv(bcln($a, $iter), bcln("2", $iter));
    }

    /*
    * Computes the base10 log using baseN log.
    * @note Requires above functions.
    * @author Thomas Oldbury.
    * @license Public domain.
    */
    function bclog10($a, $iter = 10)
    {
    return     bcdiv(bcln($a, $iter), bcln("10", $iter));
    }


    ?>
    up
    -2
    Anonymous
    19 years ago
    Well, if bcpow has limits, then this should work:
    <?php
    function bcpow_($num, $power) {
    $awnser = "1";
    while (    $power) {
    $awnser = bcmul($awnser, $num, 100);
    $power = bcsub($power, "1");
    }
    return     rtrim($awnser, '0.');
    }
    ?>
    Just that $power cannot have decimal digits in it.
    up
    -2
    Michael Bailey (jinxidoru at byu dot net)
    20 years ago
    bcpow() only supports exponents less than or equal to 2^31-1. Also, bcpow() does not support decimal numbers. If you have scale set to 0, then the exponent is converted to an interger; otherwise an error is generated.

    --
    Michael Bailey
    http://www.jinxidoru.com
    ＋add a note
    To Top