variant_add

(PHP 5, PHP 7, PHP 8)

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

Descrição

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.

Note:

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 wrappers 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