Functions > VarConv >

UBound

Donne la taille des dimensions d'un tableau ou le nombre de cl�s d'une table.

UBound ( Variable [, Dimension = 1] )

Param�tres

Variable La variable tableau ou table � examiner.
Dimension [optionnel] Pour un tableau multi-dimensionnel, la dimension dont il faut retourner la taille:
    $UBOUND_DIMENSIONS (0) = Nombre de dimensions du tableau
    $UBOUND_ROWS (1) = Nombre de rang�es du tableau (par d�faut)
    $UBOUND_COLUMNS (2) = Nombre de colonnes du tableau
Pour un Array de plus de deux dimensions, utilisez l'entier correspondant � la dimension.
Pour un Map - ce param�tre est ignor� et le nombre de cl�s est retourn�.

Les constantes sont d�finies dans "AutoItConstants.au3".

Valeur de retour

Succ�s: Retourne la taille d'une dimension d'un Array ou le nombre de cl�s d'une Map.
�chec: Retourne 0 et d�finit @error <> 0.
@error: 1 = Le param�tre Variable n'est pas un tableau (Array), ni une table (Map).
2 = La dimension du tableau est invalide.

Remarque

Rappelez-vous que pour les tableaux, la valeur retourn�e est sup�rieur de 1 � l'index du dernier �l�ment dans la dimension, puisque les index sont compt�s � partir de 0.

En relation

Global/Local, ReDim, IsArray

Exemple

#include <AutoItConstants.au3>
#include <MsgBoxConstants.au3>
#include <Array.au3> ; N�cessaire pour _ArrayDisplay.

Example()

Func Example()
    Local $aArray[10][20]
    Local $iRows = UBound($aArray, $UBOUND_ROWS) ; Nombre total de lignes. Dans cet exemple, ce sera 10.
    Local $iCols = UBound($aArray, $UBOUND_COLUMNS) ; Nombre total de colonnes. Dans cet exemple, ce sera 20.
    Local $iDimension = UBound($aArray, $UBOUND_DIMENSIONS) ; Le nombre de dimensions tableau, ici 2.

    MsgBox($MB_SYSTEMMODAL, "", "Le tableau a " & $iDimension & " dimension(s) " & _
            $iRows & " rang�e(s) & " & $iCols & " colonne(s).")

    ; Remplit le tableau avec les donn�es.
    For $i = 0 To $iRows - 1
        For $j = 0 To $iCols - 1
            $aArray[$i][$j] = "Row: " & $i & " - Col: " & $j
        Next
    Next
    _ArrayDisplay($aArray)
EndFunc   ;==>Example