array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.bcpow.php', 1 => 'bcpow', 2 => 'Élève un nombre à une puissance donnée', ), 'up' => array ( 0 => 'ref.bc.php', 1 => 'Fonctions BC Math', ), 'prev' => array ( 0 => 'function.bcmul.php', 1 => 'bcmul', ), 'next' => array ( 0 => 'function.bcpowmod.php', 1 => 'bcpowmod', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', '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 — Élève un nombre à une puissance donnée

Description

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

Élève num à la puissance exponent.

Liste de paramètres

num

La base, sous la forme d'une chaîne de caractères.

exponent

L'exposant, sous la forme d'une chaîne de caractères. Doit être une valeur sans partie fractionnaire. L'intervalle valide de l'exposant dépend de la plateforme, mais c'est au minimum de -2147483648 à 2147483647.

scale
Ce paramètre est utilisé pour définir le nombre de chiffres après la virgule dans le résultat. Si null, il prendra la valeur par défaut de l'échelle définie avec bcscale(), ou utilisera la valeur de la directive INI bcmath.scale si disponible.

Valeurs de retour

Retourne le résultat, sous la forme d'une chaîne de caractères.

Erreurs / Exceptions

Cette fonction lève une exception de type ValueError dans les cas suivants :

Cette fonction lève une exception de type DivisionByZeroError si num est 0 et que exponent est une valeur négative.

Historique

Version Description
8.4.0 Les puissances négatives de 0 renvoyaient auparavant 0, mais lèvent désormais une exception DivisionByZeroError.
8.0.0 Lorsque exponent contient une partie fractionnaire, une exception de type ValueError est désormais levée au lieu d'effectuer une troncature.
7.3.0 bcpow() retourne désormais les nombres avec la précision demandée. Auparavant, les nombres retournés pouvaient omettre les zéros décimaux de fin.

Exemples

Exemple #1 Exemple avec bcpow()

<?php

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

?>

Notes

Note:

Antérieurement à PHP 7.3.0, bcpow() peut retourner un résultat avec moins de chiffres après la virgule que le paramètre scale indique. Ceci ne se produit que lorsque le résultat ne nécessite pas toute la précision autorisée par scale. Par exemple:

Exemple #2 bcpow() exemple pour scale

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

Voir aussi