variant_add
(PHP 5, PHP 7, PHP 8)
variant_add — "Adiciona" dois valores de variante e retorna o resultado
Descrição
Adiciona left
a right
usando
as seguintes regras (tiradas da biblioteca MSDN), que correspondem às
do Visual Basic:
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.