bcadd

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

bcadd — Складывает два числа произвольной точности

Описание

bcadd(string $num1, string $num2, ?int $scale = null): string

Функцуия складывает число num1 с числом num2.

Список параметров

num1

Левый операнд (слагаемое) в виде строки.

num2

Правый операнд (слагаемое) в виде строки.

scale
Параметр используется для установки количества цифр после десятичного знака в результате. Если установлено значение null, то по умолчанию будет установлен масштаб по умолчанию, заданный с помощью функции bcscale() или значение INI-директивы bcmath.scale.

Возвращаемые значения

Функция возвращает сумму слагаемых в виде строки.

Ошибки

Функция выбрасывает исключение ValueError в следующих случаях:

  • Значение аргумента num1 или num2 оказалось строкой, которую сформировали неправильно с точки зрения допустимого формата числовых строк в модуле BCMath.
  • Значение аргумента scale выходит за пределы допустимого диапазона.

Список изменений

Версия Описание
8.0.0 Параметр scale теперь принимает значение null.

Примеры

Пример #1 Пример сложения чисел произвольной точности функцией bcadd()

<?php

$a = '1.234';
$b = '5';

echo bcadd($a, $b); // 6
echo bcadd($a, $b, 4); // 6.2340

?>

Смотрите также

  • bcsub() - Вычитает одно число произвольной точности из другого
  • BcMath\Number::add() - Складывает числа произвольной точности