Collapse the table of content
Expand the table of content
Expand Minimize

IIf Function

Office 2013 and later

Contribute to this content

Use GitHub to suggest and submit changes. See our guidelines for contributing to VBA documentation.

Returns one of two parts, depending on the evaluation of an expression.


IIf(expr, truepart, falsepart)

The IIf function syntax has these named arguments:




Required. Expression you want to evaluate.


Required. Value or expression returned if expr is True.


Required. Value or expression returned if expr is False.


IIf always evaluates both truepart and falsepart, even though it returns only one of them. Because of this, you should watch for undesirable side effects. For example, if evaluating falsepart results in a division by zero error, an error occurs even if expr is True.

This example uses the IIf function to evaluate the TestMe parameter of the CheckIt procedure and returns the word "Large" if the amount is greater than 1000; otherwise, it returns the word "Small".

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