OPALE:10.0:Utilisation:Tableaux

Tableaux

Connect permet de créer des tableaux qui sont en réalité des tables SQL embarquées auxquelles certaines fonctionnalités ont été ajoutées telles que la possibilité d'ajouter des valeurs, consulter et compter le nombre d'éléments.

Les tableaux sont un excellent moyen de stocker des données temporaires en mémoire pour y accéder rapidement lorsque c'est nécessaire.Les tableaux peuvent aussi servir à générer des listing.

Pour créer un nouveau tableau, il suffit de cliquer avec le bouton droit dans la fenêtre des Tables et de choisir Create New Array.

La fenêtre suivante s'affiche, entrer :

• le nom du tableau
• le chemin où le tableau sera sauvegardé (optionnel)

Si le chemin n'est pas spécifié, le tableau sera gardé en mémoire, exécuté, puis détruit après exécution. Par contre, si un chemin est précisé, le tableau sera sauvegardé à l'endroit indiqué de manière à pouvoir être réutilisé, y compris dans d'autres projets.

Pour ajouter des colonnes au tableau, il faut ajouter des champs (comme pour toute autre table). Pour chaque champ, il faut préciser le nom et le type. Par défaut, la valeur des champs de type Entier est 0.

Pour information, voici le code source d'une table contenant 6 colonnes et 2 index.

CreateArray("array", "E:\\array.db")
{
    AddString("region","",10)
    AddString("store","",20)
    AddString("article","",10)
    AddInt("nbVente","",10)
    AddInt("price","",10)
    AddInt("total","",10)
    SetPrimaryKey(array,"region")
    SetPrimaryKey(array,"store")
}
CreateActionsList(DB)
{
Execute(array){}
}

Fonctions de base :

La suppression des valeurs d’un tableau se fait via la fonction ClearArray (array)

La fonction DuplicateArray permet de faire une copie d’un tableau dans un autre DuplicateArray (array, array_copy)

La fonction CountArray retourne le nombre d’éléments que contient le tableau DB.nb = CountArray (array)

La fonction SumArray calcule la somme des colonnes. Les valeurs sont affectées aux champs du tableau. SumArray (array, "total", "nbVente")

Consultation des valeurs

Pour consulter des valeurs dans un tableau, il faut utiliser les fonctions Foreach et NextRead.

Foreach(array) {}
write(DB.array) {}
NextRead() {}

Ou via la fonction GetArrayValue pour une valeur du tableau en fonction d’une ligne et d’une colonne.

Exemple : pour récupérer la valeur de la colonne 5 de la ligne 10

GetArrayValue  (tableau, 10 , 5 )