Сложить значения двух вариантов

# variant_add

(PHP 5, PHP 7, PHP 8)

variant_add — Сложить значения двух вариантов

### Описание

function variant_add(mixed `$left`, mixed `$right`): variant

Складывает `left` с `right`, используя следующие правила (взято из библиотеки MSDN), в соответствии с Visual Basic:

Правила сложения вариантов
Если | То
--- | ---
Оба выражения являются строками | Конкатенация
Одно выражение строка, а второе - символ | Добавление
Одно выражение числовое, а второе строковое | Добавление
Оба выражения - числа | Добавление
Одно из выражений равно NULL | Будет возвращён NULL
Оба выражения пусты | Будет возвращён целочисленный подтип

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

`left`

  Левый операнд.

`right`

  Правый операнд.

> Замечание: Как и в остальных арифметических функциях, которые работают с вариантами, параметры этой функции принимают как встроенные PHP-типы — целые числа, строки, числа с плавающей точкой, логические значения или `null`, — так и экземпляры классов COM, VARIANT или DOTNET. Встроенные типы языка PHP преобразуются в варианты по тем же правилам, которые содержит конструктор класса variant. Объекты классов COM и DOTNET получат значение их свойства по умолчанию, которое функция возьмёт и будет использовать как значение варианта. Вариантные арифметические функции — обёртки одноимённых функций библиотеки COM; дополнительную информацию по этим функциям содержит библиотека технической документации MSDN. Названия PHP-функций немного отличаются; например, функция variant_add() в PHP соответствует функции `VarAdd()` в документации MSDN.

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

Возвращает результат.

### Ошибки

Выбрасывает исключение com_exception в случае возникновения ошибки.

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

- variant_sub() - Вычитает значение правого варианта из левого

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open