variant_mul

(PHP 5, PHP 7, PHP 8)

variant_mulMultiplica os valores de duas variantes

Descrição

variant_mul(mixed $left, mixed $right): variant

Multiplica left por right.

Parâmetros

left

O termo da esquerda.

right

O termo da direita.

Valores booleanos são convertidos em -1 para false e 0 para true.

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

Regras de Multiplicação para Variantes
If Then
Ambas as expressões são do tipo string, data, caractere, booleano Multiplicação
Uma expressão é um tipo de string e a outra um caractere Multiplicação
Uma expressão é numérica e a outra é uma string Multiplicação
Ambas as expressões são numéricas Multiplicação
Qualquer uma das expressões é NULL NULL é retornado
Ambas as expressões são vazias String vazia é retornada

Erros/Exceções

Lança uma com_exception em caso de falha.

Veja Também

  • variant_div() - Retorna o resultado da divisão de duas variantes
  • variant_idiv() - Converte variantes para inteiros e retorna o resultado da divisão deles