"Adiciona" dois valores de variante e retorna o resultado

# variant_add

(PHP 5, PHP 7, PHP 8)

variant_add — "Adiciona" dois valores de variante e retorna o resultado

### Descrição

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

Adiciona `left` a `right` usando as seguintes regras (tiradas da biblioteca MSDN), que correspondem às do Visual Basic:

Regras de Adição de Variantes
Se | Então
--- | ---
Ambas as expressões são do tipo string | Concatenação
Uma expressão é um tipo de string e a outra um caractere | Adição
Uma expressão é numérica e a outra é uma string | Adição
Ambas as expressões são numéricas | Adição
Qualquer uma das expressões é NULL | NULL é retornado
Ambas as expressões são vazias | Subtipo inteiro é retornado

### Parâmetros

`left`

  O termo da esquerda.

`right`

  O termo da direita.

> Nota: Assim como todas as funções aritméticas variantes, os parâmetros para esta função podem ser um tipo nativo do PHP (inteiro, string, ponto flutuante, booleano ou `null`) ou uma instância de uma classe COM, VARIANT ou DOTNET. Tipos nativos do PHP serão convertidos em variantes usando as mesmas regras encontradas no construtor da classe variant. Objetos COM e DOTNET terão o valor de sua propriedade padrão obtido e usado como o valor da variante. As funções aritméticas variantes são empacotadores para funções com nomes semelhantes na biblioteca COM; para mais informações sobre estas funções, consulte a biblioteca MSDN. As funções do PHP são nomeadas de forma ligeiramente diferente; por exemplo, variant_add() no PHP corresponde a `VarAdd()` na documentação da MSDN.

### Valor Retornado

Retorna o resultado.

### Erros/Exceções

Lança uma com_exception em caso de falha.

### Veja Também

- variant_sub() - Subtrai o valor da variante da direita do valor da variante da esquerda

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