Função Switch

Avalia uma lista de expressões e devolve um valor variante ou uma expressão associada à primeira expressão na lista que é Verdadeiro.

Sintaxe

Switch(expr-1, value-1, [ expr-2, value-2..., [ expr-n, value-n ]])

A sintaxe da função Switch tem as seguintes partes:

Sair	Descrição
expr	Obrigatório. Expressão de variante que pretende avaliar.
value	Obrigatório. Valor ou expressão a devolver se a expressão correspondente for Verdadeiro.

Comentários

A lista de argumentos da função Switch consiste em pares de expressões e valores. As expressões são avaliadas da esquerda para a direita e é devolvido o valor associado à primeira expressão a avaliar como Verdadeiro .

Se as partes não estiverem corretamente emparelhadas, ocorre um erro de tempo de execução . Por exemplo, se expr-1 for Verdadeiro, Switch devolve value-1. Se expr-1 for Falso, mas expr-2 for Verdadeiro, Switch devolve o valor-2 e assim sucessivamente.

O parâmetro devolve um valor Nulo se:

• Nenhuma das expressões é Verdadeira.

• A primeira expressão True tem um valor correspondente que é Nulo.

O Parâmetro avalia todas as expressões, apesar de devolver apenas uma delas. Por esse motivo, você deve ter cuidado com efeitos colaterais indesejados. Por exemplo, se a avaliação de qualquer expressão resultar num erro de divisão por zero, ocorrerá um erro.

Exemplo

Este exemplo utiliza a função Switch para devolver o nome de um idioma que corresponde ao nome de uma cidade.

Function MatchUp(CityName As String)
    Matchup = Switch(CityName = "London", "English", CityName _
                    = "Rome", "Italian", CityName = "Paris", "French")
End Function

Confira também

• Funções (Visual Basic for Applications)

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.