array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.bcpow.php', 1 => 'bcpow', 2 => 'Elevar un número de precisión arbitraria a otro', ), 'up' => array ( 0 => 'ref.bc.php', 1 => 'Funciones de BC Math', ), 'prev' => array ( 0 => 'function.bcmul.php', 1 => 'bcmul', ), 'next' => array ( 0 => 'function.bcpowmod.php', 1 => 'bcpowmod', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/bc/functions/bcpow.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

bcpow

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

bcpow — Elevar un número de precisión arbitraria a otro

Descripción

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

Eleva num a la potencia exponent.

Parámetros

num

La base, como un string.

exponent

El exponente, como un string. Debe ser un valor sin parte fraccionaria. El rango válido del exponente es específico de la plataforma, pero es al menos de -2147483648 a 2147483647.

scale
Este parámetro se utiliza para establecer el número de dígitos después del punto decimal en el resultado. Si es null, se establecerá por defecto en la escala predeterminada establecida con bcscale(), o se utilizará el valor de la directiva INI bcmath.scale.

Valores devueltos

Devuelve el resultado como un string.

Errores/Excepciones

Esta función lanza una ValueError en los siguientes casos:

Esta función lanza una DivisionByZeroError si num es 0 y exponent es un valor negativo.

Historial de cambios

Versión Descripción
8.4.0 Las potencias negativas de 0 anteriormente devolvían 0, pero ahora lanzan una excepción DivisionByZeroError.
8.0.0 Cuando exponent tiene una parte fraccionaria, ahora lanza un ValueError en lugar de truncar.
7.3.0 bcpow() ahora devuelve números con la escala solicitada. Anteriormente, los números devueltos podían omitir los ceros decimales finales.

Ejemplos

Ejemplo #1 Ejemplo de bcpow()

<?php

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

?>

Notas

Nota:

Antes de PHP 7.3.0, bcpow() podría devolver un resultado con menos dígitos después del punto decimal que los indicados en el parámetro scale. Esto sucede únicamente cuando el resultado no necesita toda la precisión disponible por scale. Por ejemplo:

Ejemplo #2 Ejemplo de escalado de bcpow()

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

Ver también