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

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 à

Voir aussi