Functions > Map >

MapKeys

Construit un tableau avec toutes les clés d'une table.

MapKeys ( map )

Paramètre

map Une table existante

Valeur de retour

Succès: Retourne un tableau de dimension 1 contenant les clés.
Echec: Retourne un tableau, de base 0, et définit @error <> 0

Remarques

Le tableau retourné peut être utilisé pour itérer les valeurs contenu dans la table

Les fonctions Map ne sont pas disponibles dans la version AutoIt 3.3.14.5 mais peuvent être testées dans la version Béta (Alt-F5).

Exemple

#include <MsgBoxConstants.au3>

Example()

Func Example()
    ; Déclare une table et l'assigne avec des paires clé/valeur.
    Local $mMap[]
    $mMap[1] = "Integer One" ; Valeur entière pour cette clé.
    $mMap["2"] = "String Two" ; Valeur chaîne representant un entier pour cette clé. C'est une chaîne, pas un nombre.
    MapAppend($mMap, "Integer Two") ; Ajoute une valeur en utilisant l'entier suivant disponible, qui est 2 dans ce cas.

    ; Obtient les clés contenues dans la table. Un tableau de dimension 1, de base 0, est retourné.
    Local $aMapKeys = MapKeys($mMap)
    For $vKey In $aMapKeys ; Ou une boucle For convient aussi bien.
        MsgBox($MB_SYSTEMMODAL, "", "Clé: " & $vKey & @CRLF & _ ; La clé.
                "Valeur: " & $mMap[$vKey] & @CRLF & _ ; Utilise la valeur tableau de MapKeys() pour afficher la valeur de la clé.
                "Type de Variable: " & VarGetType($vKey) & @CRLF) ; Affiche le type de la variable de la clé i.e. entier ou chaîne.
    Next
EndFunc   ;==>Example