UBOUND

Syntaxe

Paramètres

Description

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

Remarques

• UBound permet de connaître la taille d'un tableau dynamiquement : La fonction UBound est indispensable lorsqu'on travaille avec des tableaux dont la taille n'est pas fixe ou connue à l'avance. Elle retourne l'index le plus élevé utilisable dans le tableau, ce qui permet de parcourir ce dernier avec précision dans des boucles comme For...Next, sans provoquer d'erreurs de dépassement de bornes.
• Elle retourne un index, et non le nombre total d'éléments : Il est important de ne pas confondre UBound avec une fonction donnant le nombre total d'éléments du tableau. En effet, comme les tableaux en VBScript commencent généralement à l'indice 0, un tableau à 5 éléments aura une borne supérieure (UBound) de 4. Cela nécessite d'adapter les calculs si l'on veut connaître la taille réelle.
• Très utile dans les tableaux dynamiques redimensionnés avec ReDim : Lorsque l'on redimensionne un tableau dynamiquement avec ReDim, la fonction UBound permet de connaître la nouvelle borne supérieure sans avoir à la mémoriser manuellement. Cela garantit que les traitements suivant s'adaptent à la taille actuelle du tableau, quelle qu'en soit l'évolution au fil du script.
• Utile pour vérifier si un tableau contient des éléments : Combinée à LBound, la fonction UBound permet de déterminer si un tableau contient au moins un élément. Par exemple, si UBound(tab) < LBound(tab), cela indique un tableau vide ou mal initialisé. Ce type de test est essentiel pour éviter des erreurs lors de l'accès aux éléments.
• Ne fonctionne que sur des variables effectivement déclarées comme tableaux : Si l'on utilise UBound sur une variable n'étant pas un tableau, une erreur d'exécution est générée. Il est donc judicieux d'utiliser IsArray en amont pour vérifier la nature de la variable. Cela permet de sécuriser les scripts ASP et d'éviter des arrêts brutaux en production.
• Particulièrement utile pour traiter des résultats multiples : Dans le cas où une fonction retourne un tableau de résultats (par exemple, après une opération de découpage avec Split), UBound permet de connaître rapidement combien de valeurs ont été retournées. Cela facilite le traitement automatique de listes, de chaînes décomposées ou d'ensembles de données.
• Gère les tableaux multidimensionnels avec un paramètre supplémentaire : La version étendue de UBound accepte un second paramètre pour spécifier la dimension à interroger dans un tableau multidimensionnel. Par exemple, UBound(tab, 2) retourne la borne supérieure de la deuxième dimension. Cela permet une navigation fine dans des structures de données complexes.
• Une fonction rapide et légère en termes de performance : UBound est une fonction native très rapide à exécuter, ce qui la rend idéale pour les traitements en boucle ou les contrôles fréquents. Elle ne crée pas de surcharge significative et peut être utilisée de manière intensive dans des scripts optimisés pour la performance.

Exemple

Voici un exemple d'une utilisation typique de cette fonction :

on obtiendra le résultat suivant :

Voir également

Articles - Les géants de l'informatique - Microsoft