Gambas Documentation
Aperçu du Langage
À traduire
Code Snippets
Comment faire ...
Compilation et installation
Composants
gb
.Array.Bounds
.Stat.Perm
.Stream.Lines
.Symbol
Application
Args
Array
Boolean[]
Byte[]
Class
Classes
Collection
_get
_new
_next
_put
Add
Clear
Copy
Count
Exist
Key
Length
Remove
Component
Components
Date[]
Enum
Env
Error
File
Float[]
gb
Integer[]
Long[]
Object
Object[]
Observer
Param
Pointer[]
Process
Short[]
Single[]
Stat
Stream
String
String[]
System
Timer
User
Variant[]
gb.args
gb.cairo
gb.clipper
gb.complex
gb.compress
gb.crypt
gb.db
gb.db.form
gb.dbus
gb.debug
gb.desktop
gb.desktop.gnome.keyring
gb.eval
gb.eval.highlight
gb.form
gb.form.dialog
gb.form.editor
gb.form.mdi
gb.gmp
gb.gsl
gb.gtk
gb.gtk3
gb.gui
gb.image
gb.image.effect
gb.image.imlib
gb.image.io
gb.inotify
gb.libxml
gb.media
gb.mysql
gb.net
gb.net.curl
gb.net.smtp
gb.openal
gb.opengl
gb.opengl.glsl
gb.opengl.glu
gb.opengl.sge
gb.option
gb.pcre
gb.pdf
gb.qt4
gb.qt4.ext
gb.qt4.opengl
gb.qt4.webkit
gb.qt5
gb.qt5.opengl
gb.report
gb.scanner
gb.sdl
gb.sdl.sound
gb.settings
gb.signal
gb.util
gb.util.web
gb.v4l
gb.vb
gb.web
gb.web.feed
gb.xml
gb.xml.html
gb.xml.rpc
gb.xml.xslt
Controls pictures
Derniers changements
Dépôt d'applications
Documentation de l'Environnement de développement
Documentation des développeurs
Documents
Indenter
Index de tous les Documents
Index du langage
Lexique
LISEZ-MOI
Manuel du wiki
Messages d'erreur
Tutoriels
Wiki License

Collection (gb)

Implémente une table de hachage dont les clefs (keys) sont des String et les valeurs associées des Variant.

NULL est utilisé lorsqu'aucun élément est associé à la clef donnée. En conséquence, associer NULL à une clef revient au même qu'enlever celle-ci de la collection.

La taille de la table interne de hachage grossit dynamiquement au fur et à mesure que des données y sont insérées.

Cette classe est instanciable.

Cette classe se comporte comme un tableau en lecture / écriture.

Cette classe est énumérable à l'aide du mot-clef FOR EACH.

Propriétés
Count   Renvoie le nombre d'éléments enregistrés dans la collection.
Default  
Empty  
First  
Key   Retourne la clef (key) du dernier élément lu ou énuméré.
Keys  
Last  
Length   Retourne le nombre d'éléments enregistrés dans la collection.

Méthodes
Add   Ajoute un élément à la collection.
Clear   Efface la collection.
Copy   Retourne une copie de la collection.
Exist   Retourne si un élément est associé avec cette clef (key) dans la collection.
Remove   Supprime un élément de la collection.

Exemple

PUBLIC SUB Main()

  DIM cAbbr2Weekday AS Collection = ["mo": "Monday", "tu": "Tuesday", "we": "Wednesday", "th": "Thursday", "fr": "Friday", "sa": "Saturday", "su": "Sunday"]
  DIM cCopy AS Collection
  DIM sAbbr AS String
  
  ' Pour accéder aux données
  PRINT cAbbr2Weekday["fr"]
  
  ' Afficher clef et la valeur correspondante
  FOR EACH sAbbr IN cAbbr2Weekday
    PRINT cAbbr2Weekday.Key & " --> " & sAbbr
  NEXT

  ' Longueur/Compte retournent tous les deux 7
  PRINT cAbbr2Weekday.Count
  PRINT cAbbr2Weekday.Length

  ' Ajouter un élément et le supprimer de nouveau 
  cAbbr2Weekday.Add("sat", "Saturday")
  cAbbr2Weekday.Remove("sat")
  
  ' Tester si une clef est présente
  PRINT cAbbr2Weekday.Exist("we")
  
  ' Faire une copie et effacer la collection originale
  cCopy = cAbbr2Weekday.Copy()
  cAbbr2Weekday.Clear()

END