php man page for bcpow

BCPOW(3)								 1								  BCPOW(3)

bcpow - Raise an arbitrary precision number to another

SYNOPSIS
       string bcpow (string  $left_operand, string  $right_operand, [int  $scale])

DESCRIPTION
	Raise $left_operand to the power $right_operand.

PARAMETERS
	      o $left_operand
		- The left operand, as a string.

	      o $right_operand
		- The right operand, as a string.

	      o $
		scale  -This  optional	parameter  is used to set the number of digits after the decimal place in the result. You can also set the
		global default scale for all functions by using bcscale(3).

RETURN VALUES
	Returns the result as a string.

EXAMPLES
       Example #1

	      bcpow(3) example

	      <?php

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

	      ?>

NOTES
       Note

	      bcpow(3) 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:

	      Example #2

		     bcpow(3) scale example

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

SEE ALSO
       bcpowmod(3), bcsqrt(3).

PHP Documentation Group 														  BCPOW(3)