WorksheetFunction.Match(Object, Object, Object) Méthode

Définition

Renvoie la position relative d'un élément dans une matrice, qui correspond à une valeur spécifiée dans un ordre spécifié. Utilisez Match au lieu de l’une des fonctions lorsque vous avez besoin de la position d’un élément dans une plage au lieu Lookup(Object, Object, Object) de l’élément lui-même.

public double Match (object Arg1, object Arg2, object Arg3);
Public Function Match (Arg1 As Object, Arg2 As Object, Optional Arg3 As Object) As Double

Paramètres

Arg1
Object

Lookup_value - valeur que vous utilisez pour rechercher la valeur souhaitée dans un tableau.

Arg2
Object

Lookup_array - plage de cellules contiguës contenant des valeurs de recherche possibles. Lookup_array doit être une matrice ou une référence à une matrice.

Arg3
Object

Type - nombre -1, 0 ou 1. Type spécifie la manière dont Microsoft Excel recherche Lookup_value dans Lookup_array.

Retours

Double

Remarques

Lookup_value est la valeur pour laquelle vous voulez trouver une correspondance dans Lookup_array. Par exemple, lorsque vous recherchez le numéro d’une personne dans un annuaire téléphonique, vous utilisez le nom de la personne comme valeur de recherche, mais le numéro de téléphone est la valeur que vous souhaitez.

Lookup_value peut être une valeur (nombre, texte ou valeur logique) ou une référence de cellule à un nombre, du texte ou une valeur logique.

Si match_type est égal à 1, Match trouve la plus grande valeur inférieure ou égale à lookup_value. Lookup_array doit être placé dans l’ordre croissant : ...-2, -1, 0, 1, 2, ..., A-Z, false, true.

Si match_type est égal à 0, Match trouve la première valeur qui est exactement égale à lookup_value. Lookup_array peut se trouver dans un ordre quelconque.

Si match_type est -1, Match trouve la plus petite valeur supérieure ou égale à lookup_value. Lookup_array doit être placée dans l’ordre décroit : true, false, Z-A, ... 2, 1, 0, -1, -2, ..., etc. Si match_type est omis, il est supposé être 1.

La fonction Match renvoie la position de la valeur de correspondance dans lookup_array, et non la valeur elle-même. Par exemple, la fonction MATCH("b",{"a","b","c"},0) renvoie 2, la position relative de « b » dans la matrice {"a","b","c"}.

La correspondance ne fait pas la distinction entre les lettres majuscules et minuscules lors de la mise en correspondance des valeurs de texte.

Si la correspondance échoue à trouver une correspondance, elle renvoie la valeur d'#N/A.

Si match_type la valeur 0, vous pouvez utiliser des caractères génériques, des points d'interrogation (?) et des astérisques (*), dans lookup_value. Un point d'interrogation correspond à un caractère unique, un astérisque à une séquence de caractères. Si vous souhaitez rechercher un point d'interrogation ou un astérisque, entrez un tilde (~) avant le caractère.

S’applique à