bcscale

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

bcscale — すべての BC 演算関数におけるデフォルトのスケールを設定/取得する

説明

bcscale(int $scale): int

デフォルトのスケールを設定します。これ以降、 BC 演算関数で明示的にスケールを指定しなかった場合にこの値を使用します。

bcscale(null $scale = null): int

現在のスケールを取得します。

パラメータ

scale: スケール。

戻り値

スケールを設定する場合は、古いスケールを返します。そうでない場合、現在のスケールを返します。

エラー / 例外

This function throws a ValueError if scale is outside the valid range.

変更履歴

バージョン	説明
8.0.0	`scale` は、nullable になりました。
7.3.0	bcscale() は、現在のスケールを取得するために使えるようになりました。スケールを設定する場合は、古いスケールの値を返します。これより前のバージョンでは、 `scale` の指定が強制され、 bcscale() は常に `true` を返していました。

例

例1 bcscale() の例

<?php

// デフォルトのスケールを 3 とします
bcscale(3);
echo bcdiv('105', '6.55957'); // 16.007

// これは、bcscale() を使用せずにおなじ結果を得ます
echo bcdiv('105', '6.55957', 3); // 16.007

?>

Found A Problem?

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

＋add a note

User Contributed Notes 4 notes

down

mwgamera at gmail dot com ¶

17 years ago

These functions DO NOT round off your values. No arbitrary precision libraries do it this way. It stops calculating after reaching scale of decimal places, which mean that your value is cut off after scale number of digits, not rounded. To do the rounding use something like this:
<?php
        function bcround($number, $scale=0) {
                $fix = "5";
                for ($i=0;$i<$scale;$i++) $fix="0$fix";
                $number = bcadd($number, "0.$fix", $scale+1);
                return    bcdiv($number, "1.0",    $scale);
        }
?>

down

sicerwork at aliyun dot com ¶

7 years ago

Executing bcsacle() will change the scale value of fpm.conf, not only the current process.

down

ravenswd at gmail dot com ¶

12 years ago

Simple, easy way to remove excess trailing zeros using rtrim:
<php>
  // $total is the result of a bcmath calculation
  if ( strpos($total, '.') !== false ):
    $total = rtrim($total, '0');
    $total = rtrim($total, '.');
  endif;
</php>

down

herslyadam at gmail dot com ¶

10 years ago

edited bcround function with negative number support:
<?php
function bcround($number, $scale=0) {
    if($scale < 0) $scale = 0;
    $sign = '';
    if(bccomp('0', $number, 64) == 1) $sign = '-';
    $increment = $sign . '0.' . str_repeat('0', $scale) . '5';
    $number = bcadd($number, $increment, $scale+1);
    return bcadd($number, '0', $scale);
}
?>

＋add a note