Information.UBound(Array, Int32) Méthode

Définition

Espace de noms:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

Retourne l’indice disponible le plus élevé pour la dimension indiquée d’un tableau.

public static int UBound(Array Array, int Rank = 1);
static member UBound : Array * int -> int
Public Function UBound (Array As Array, Optional Rank As Integer = 1) As Integer

Paramètres

Array
Array

Required. Tableau de n’importe quel type de données. Tableau dans lequel vous souhaitez trouver l’indice le plus élevé possible d’une dimension.

Rank
Int32

Optional. Integer. Dimension pour laquelle l’indice le plus élevé possible doit être retourné. Utilisez 1 pour la première dimension, 2 pour la deuxième, et ainsi de suite. S’il Rank est omis, 1 est supposé.

Retours

Int32

Integer. La valeur la plus élevée de l’indice pour la dimension spécifiée peut contenir. Si Array n’a qu’un seul élément, UBound retourne 0. Si Array aucun élément n’est associé, par exemple s’il s’agit d’une chaîne de longueur nulle, UBound retourne -1.

Exceptions

ArgumentNullException

Array a la valeur Nothing.

RankException

Rank est inférieur à 1, ou Rank est supérieur au rang de Array.

Exemples

L’exemple suivant utilise la UBound fonction pour déterminer l’indice disponible le plus élevé pour la dimension indiquée d’un tableau.

Dim highest, bigArray(10, 15, 20), littleArray(6) As Integer
highest = UBound(bigArray, 1)
highest = UBound(bigArray, 3)
highest = UBound(littleArray)
' The three calls to UBound return 10, 20, and 6 respectively.

Remarques

Étant donné que les indices de tableau commencent à 0, la longueur d’une dimension est supérieure à l’un des indices disponibles les plus élevés pour cette dimension.

Pour un tableau avec les dimensions suivantes, UBound retourne les valeurs du tableau suivant :

Dim a(100, 5, 4) As Byte
Appel à UBound Valeur renvoyée
UBound(a, 1) 100
UBound(a, 2) 5
UBound(a, 3) 4

Vous pouvez utiliser UBound pour déterminer le nombre total d’éléments d’un tableau, mais vous devez ajuster la valeur qu’elle retourne pour tenir compte du fait que les indices commencent à 0. L’exemple suivant calcule la taille totale du tableau a dans l’exemple précédent :

Dim total As Integer
total = (UBound(A, 1) + 1) * (UBound(A, 2) + 1) * (UBound(A, 3) + 1)

La valeur calculée est total 3030, soit 101 * 6 * 5.

S’applique à

Voir aussi