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