Functions > Map >


MapAppend

Ajoute un élément à une table en lui attribuant une clé.

MapAppend ( map, value )

Paramètres

map Une table existante
value La valeur à ajouter

Valeur de retour

Succès: Retourne la clé de type entier utilisée pour ajouter la valeur
Echec: Retourne 0 et définit @error <> 0

Remarques

La valeur sera ajoutée en utilisant la clé de type nombre entier suivante disponible.

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, après installation).

En relation

MapRemove

Exemple

#include <MsgBoxConstants.au3>

Example()

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

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