Função Alternar
Avalia uma lista de expressões e retorna um valor Variant ou uma expressão associada à primeira expressão na lista que é True.
Sintaxe
Switch(expr-1, value-1, [ expr-2, value-2..., [ expr-n, value-n ]])
A sintaxe da função Switch tem estas partes:
| Sair | Descrição |
|---|---|
| expr | Obrigatório. Expressão variant que você deseja avaliar. |
| value | Obrigatório. Valor ou expressão a ser retornado se a expressão correspondente for True. |
Comentários
A lista de argumentos de função do Switch consiste em pares de expressões e valores. As expressões são avaliadas da esquerda para a direita e o valor associado à primeira expressão a ser avaliada como True é retornado.
Se as partes não estiverem emparelhadas corretamente, ocorrerá um erro em tempo de execução . Por exemplo, se expr-1 for True, o Switch retornará o valor 1. Se expr-1 for False, mas expr-2 for True, o Switch retornará o valor 2 e assim por diante.
O Switch retornará um valor Nulo se:
Nenhuma das expressões é True.
A primeira expressão True tem um valor correspondente que é Null.
O Switch avalia todas as expressões, embora retorne 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 em uma divisão por erro zero, ocorrerá um erro.
Exemplo
Este exemplo usa a função Switch para retornar 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
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.