méthode WorksheetFunction.Rank_Eq (Excel)

Renvoie le rang d’un nombre dans une liste de nombres. Le rang d’un nombre est donné par sa taille comparée aux autres valeurs de la liste. Si vous deviez trier la liste, le rang du nombre serait sa position.

Syntaxe

expression. Rank_Eq (Arg1, Arg2, Arg3)

Expression Variable qui représente un objet WorksheetFunction .

Parameters

Nom Requis/Facultatif Type de données Description
Arg1 Obligatoire Double Nombre : nombre dont vous souhaitez connaître le rang.
Arg2 Obligatoire Range Référence : matrice ou référence à une liste de nombres. Les valeurs non numériques sont ignorées dans la référence.
Arg3 Facultatif Variant Ordre : nombre spécifiant le mode de classement du nombre.

Valeur renvoyée

Double

Remarques

Si l’ordre est égal à 0 (zéro) ou omis, Microsoft Excel classe le nombre comme si la référence était une liste triée dans l’ordre décroissant.

Si l’ordre est une valeur différente de zéro, Excel classe le nombre comme si la référence était une liste triée par ordre croissant.

Rank_Eq donne le même rang aux nombres en double. Cependant, la présence de nombres en double affecte les rangs des nombres suivants. Par exemple, dans une liste d’entiers triés par ordre croissant, si le nombre 10 apparaît deux fois et a un rang de 5, 11 a un rang de 7 (aucun nombre n’a un rang de 6).

Pour certaines raisons, vous souhaiterez utiliser une définition d’un rang qui prend les liens en compte. Dans l’exemple précédent, vous souhaitez utiliser un rang révisé de 5,5 pour le numéro 10. Pour ce faire, ajoutez le facteur de correction suivant à la valeur retournée par Rank_Eq. Ce facteur de correction est approprié dans les deux cas où le rang est calculé dans l’ordre décroissant (ordre = 0 ou omis) ou l’ordre croissant (ordre = valeur différente de zéro).

  • Facteur de correction pour les rangs liés =[COUNT(ref) + 1 – RANK_EQ(number, ref, 0) – RANK_EQ(number, ref, 1)]/2.

  • Dans l’exemple suivant, RANK_EQ(A2,A1:A5,1) est égal à 3. Le facteur de correction est (5 + 1 – 2 – 3)/2 = 0,5, et le rang révisé qui prend en compte les liens est 3 + 0,5 = 3,5.

  • Si le nombre ne se produit qu’une seule fois dans la référence, le facteur de correction sera 0, car Rank_Eq n’aurait pas besoin d’être ajusté pour une égalité.

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.