WorksheetFunction.Match (Excel)

Retorna a posição relativa de um item em uma matriz que corresponde a um valor especificado em uma ordem especificada. Use Match ao invés de uma das funções Lookup quando precisar da posição de um item em um intervalo, em vez do próprio item.

Valor_procurado é o valor que você deseja corresponder em matriz_procurada. Por exemplo, quando você pesquisa um número em um catálogo telefônico, você está usando o nome da pessoa como o valor de pesquisa, mas o número de telefone é o valor desejado. Lookup_value pode ser um valor (número, texto ou valor lógico) ou uma referência de célula para um número, texto ou valor lógico. Se tipo_correspondência for 1, CORRESP localizará o maior valor que é menor ou igual a valor_procurado. Lookup_array deverá ser posicionado em ordem crescente:...-2, -1, 0, 1, 2,..., A-Z, FALSE, TRUE. Se tipo_correspondência for 0, CORRESP localizará o primeiro valor que é exatamente igual a valor_procurado. Lookup_array poderá estar em qualquer ordem. Observe que a correspondência diferencia maiúsculas de minúsculas. Se tipo_correspondência for-1, CORRESP localizará o menor valor maior ou igual a valor_procurado. Matriz_procurada deve ser colocada em ordem decrescente: VERDADEIRO, FALSO, Z-A... 2, 1, 0, -1, -2... e assim por diante. Se match_type for omitido, será considerado 1. Match retorna a posição do valor correspondente dentro de matriz_procurada, não o próprio valor. Por exemplo, MATCH("b",{"a","b","c"},0) retorna 2, a posição relativa de "b" dentro da matriz {"a","b","c"}. Match não faz distinção entre letras maiúsculas e minúsculas ao coincidir valores de texto. Se Match não tiver êxito ao localizar uma correspondência, ele retornará o valor de erro #N/a. Se match_type for 0 e lookup_value for texto, você poderá usar os caracteres curinga, ponto de interrogação (?) E asterisco (*), em lookup_value. Um ponto de interrogação corresponde a qualquer caractere único; um asterisco corresponde a qualquer cadeia de caracteres. Se você quiser localizar um ponto interrogação ou asterisco real, digite um til (~) antes do caractere.

Match (Arg1, Arg2, Arg3)

Dim dblMatch As Double
dblMatch = WorksheetFunction.Match(Arg1:=, Arg2:=)

Arguments

Arg1 - Valor_procurado: o valor que você usa para localizar o valor desejado em uma tabela

Arg2 - Matriz_procurada: um intervalo contíguo de células que contêm os valores de pesquisa possíveis. Matriz_procurada deve ser uma matriz ou uma referência de matriz

Arg3 - Tipo_correspondência: o número -1, 0 ou 1. Match_type especifica como o Microsoft Excel encontra o Lookup_value correspondente em Lookup_array