UBound

Syntaxe

Paramètres

Description

Cette fonction permet de demander le nombre d'élément maximum (borne supérieur) d'un tableau.

Remarques

• La fonction UBound est utilisée pour obtenir la borne supérieure d'un tableau, c'est-à-dire l'indice de la dernière position valide dans le tableau. Cela est essentiel pour déterminer la taille du tableau, notamment lorsqu'on travaille avec des boucles ou des opérations qui nécessitent de connaître la limite du tableau.
• Le paramètre tableau passé à la fonction UBound est obligatoire et doit être un tableau valide. Si ce paramètre n'est pas un tableau ou est Empty, la fonction renverra une erreur d'exécution. Il est donc important de vérifier que le tableau est bien initialisé avant d'utiliser cette fonction.
• L'index retourné par UBound est basé sur l'index de l'élément final du tableau, et non sur le nombre total d'éléments. Par exemple, pour un tableau de 10 éléments indexés de 0 à 9, UBound renverra 9, ce qui représente l'indice de l'élément à la dernière position du tableau.
• Une particularité de UBound est qu'elle prend en compte les tableaux multidimensionnels. Dans ce cas, il est possible de spécifier un paramètre optionnel indiquant la dimension pour laquelle on souhaite obtenir la borne supérieure. Par exemple, UBound(tableau, 2) renverra la borne supérieure de la deuxième dimension d'un tableau bidimensionnel.
• Il est important de noter que les tableaux en VBScript peuvent avoir des index ne commençant pas nécessairement à 0. Par exemple, si un tableau a été initialisé avec des index personnalisés, UBound retournera l'indice de l'élément supérieur en tenant compte de cette personnalisation.
• UBound est couramment utilisée dans les boucles pour itérer sur un tableau en s'assurant de ne pas sortir des limites du tableau. Par exemple, dans une boucle For, vous pouvez utiliser UBound pour déterminer la fin de l'itération et éviter les erreurs liées à des indices hors limites.
• La fonction UBound renverra 0 si le tableau contient un seul élément, et -1 si le tableau est vide (ou non initialisé), ce qui est une caractéristique importante à prendre en compte lors de la gestion des tableaux dynamiques ou lors de l'utilisation des fonctions de tableau conditionnelles.
• Il est aussi possible d'utiliser UBound en combinaison avec d'autres fonctions, comme LBound, pour obtenir à la fois la borne inférieure et la borne supérieure d'un tableau. Cela est utile lorsqu'on veut traiter des tableaux qui ne commencent pas forcément à l'index 0 et qui peuvent être définis avec des indices personnalisés.