Função IIf

  • Artigo

Retorna uma de duas partes, dependendo da avaliação de uma expressão.

Sintaxe

IIf(expr, parteverdadeira, partefalsa)

A sintaxe da função IIf tem estes argumentos nomeados:

Parte Descrição
expr Obrigatório. A expressão que você deseja avaliar.
parteverdadeira Obrigatório. Valor ou expressão retornados se expr for True.
partefalsa Obrigatório. Valor ou expressão retornados se expr for Falsa.

Comentários

IIf sempre avalia parteverdadeira e partefalsa, embora retorne apenas uma delas. Por isso, tome cuidado com efeitos colaterais indesejáveis. Por exemplo, se a avaliação de partefalsa resultar em uma divisão por zero, ocorrerá um erro mesmo se expr for True.

Exemplo

Este exemplo usa a função IIf para avaliar o parâmetro TestMe do procedimento CheckIt. Ele retornará a palavra "Large" se o valor for maior que 1.000; caso contrário, retornará a palavra "Small".

Function CheckIt (TestMe As Integer)
    CheckIt = IIf(TestMe > 1000, "Large", "Small")
End Function

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.