XMATCH Function

Contenu

# XMATCH

Searches for a value in a one-dimensional array and returns the relative position of the item.

XMATCH outperforms function MATCH as it allows searches according to the search mode.

### Syntaxe

EQUIVX(recherche;matrice [;TypeEquivalence [;ModeRecherche ] ] )

Recherche : la valeur de tout type à rechercher dans Matrice.

Matrice : est la référence de la matrice ou de la plage à rechercher.

TypeEquivalence : (facultatif) spécifie le type de correspondance. Les valeurs peuvent être :

- 0 : correspondance exacte (par défaut). Si la valeur Recherche n'est pas trouvée, renvoie l'erreur #N/D.

- -1 : tentative de correspondance exacte. Si la valeur Recherche n'est pas trouvée, renvoie l'élément plus petit suivant.

- 1 : tentative de correspondance exacte. Si la valeur Rercherche n'est pas trouvée, renvoie l'élément suivant plus grand.

- 2: a wildcard match where characters *, ?, and ~ have special meanings.

- 3: a regular expression match.

Search Mode: (optional) specifies the search mode to use.

- 1: returns the first occurrence starting from the first item of Search Array (default).

- -1: reverse search. Returns the first occurrence starting from the last item of Search Array.

- 2: binary search that relies on Search Array being sorted in ascending order. If not sorted, invalid results will be returned.

- -2: binary search that relies on Search Array being sorted in descending order. If not sorted, invalid results will be returned.

Match Mode values 2 and 3 cannot be combined with binary search (Search Mode value 2 or -2).

N'importe quel arguments facultatifs peut être omis. Un argument facultatif nécessite que tous les séparateurs précédents soient présents.

### Exemples

Supposons que nous ayons construit une petite table de base de données occupant la plage de cellules A1:DO4 et contenant des informations de base sur 118 éléments chimiques. La première colonne contient les en-têtes de ligne " Élément ", " Symbole ", " Numéro atomique " et " Masse atomique relative ". Les colonnes suivantes contiennent les informations pertinentes pour chacun des éléments, classées de gauche à droite par numéro atomique. Par exemple, les cellules B1:B4 contiennent "Hydrogène", "H", "1" et "1,008", tandis que les cellules DO1:DO4 contiennent "Oganesson", "Og", "118" et "294".

| A | B | C | D | ... | DO
--- | --- | --- | --- | --- | --- | ---
1 | Élément | Hydrogène | Hélium | Lithium | ... | Oganesson
2 | Symbole | H | He | Li | ... | Og
3 | Numéro atomique | 1 | 2 | 3 | ... | 118
4 | Masse atomique relative | 1.008 | 4.0026 | 6.94 | ... | 294

=EQUIVX("Numéro atomique", A1:A4) renvoie 3, la troisième ligne de la matrice A1:A4.

=EQUIVX("Li", A2:DO2) renvoie 4, la quatrième colonne de la matrice A2:DO2.

#### Informations techniques

Cette fonction est disponible depuis LibreOffice 24.8.

Cette fonction ne fait pas partie de Open Document Format for Office Applications (OpenDocument) Version 1.3. Partie 4 : Norme de format de formule recalculée (OpenFormula). L'espace de nom est

COM.MICROSOFT.XMATCH

Rubriques connexes

XLOOKUP

XMATCH wiki page.