Information.UBound(Array, Int32) Méthode

Référence

Définition

Espace de noms:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Source:: Information.vb

Source:: Information.vb

Source:: Information.vb

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Retourne le plus grand indice disponible 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

Obligatoire. Tableau de tout type de données. Tableau dans lequel vous voulez trouver le plus grand indice possible d'une dimension.

Rank: Int32

Optionnel. Integer. Dimension pour laquelle le plus grand indice possible doit être retourné. Utilisez la valeur 1 pour la première dimension, la valeur 2 pour la deuxième, etc. Si Rank cet argument est omis, la position 1 est utilisée par défaut.

Retours

Int32

Integer. Valeur la plus élevée que l'indice pour la dimension spécifiée peut contenir. Si Array a un seul élément, UBound retourne 0. Si Array n'a pas d'éléments, par exemple si c'est 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 le plus élevé disponible 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 d’un à l’indice le plus élevé disponible 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 retourné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 dans un tableau, mais vous devez ajuster la valeur qu’il 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 pour total est 3030, soit 101 * 6 * 5.

S’applique à

Partager via