Beaussier en ligne

Les variables de tableau (appelées en anglais array) permettent de stocker des valeurs.
Dans d'autres langages, on peut aussi les dénommer par table mémoire.
On les appelle comme cela car elles sont exactement représentées comme dans une feuille de calcul. L'accès se fait donc par un indice qui correspond à la ligne ou la colonne.

La vitesse d'exécution d'une variable tableau est beaucoup plus rapide que dans une feuille sous Calc.
Cela vient du fait que tout se passe en mémoire vive (RAM). Cela varie de la puissance de la machine mais on peut parler d'un facteur de 1 à 10.
Dès lors, faire des tris, du filtrage ou des recherches sera beaucoup plus rapide en passant par une variable tableau.

En revanche, il ne s'agit que de la transposition des données uniquement (chaîne ou nombre). Vous ne pouvez pas accéder à d'autres informations comme la mise en forme de la cellule ou la formule qu'elle contient. Si vous cherchez à récupérer cela, utilisez zBasic qui propose des fonctions en français très simples.

***

Plusieurs méthodes possibles :

L'instruction Dim permet de dimensionner en mémoire la variable oTableau de 51 chaînes.
Pourquoi 51 ? Parce que l'index démarre à zéro.
Si vous voulez un tableau de 50 lignes, il suffit de déclarer 49 en valeur.

On peut aussi caractériser la variable avec d'autres types de données.
déclare un tableau de 10 entiers longs

Si vous ne passez aucun type, Basic déclarera votre tableau avec du Variant. C'est une variable passe-partout qui peut contenir n'importe quel type de donnée.

Simplification de déclaration
On peut aussi simplifier en "typant" la variable directement. Ainsi : typera oTableau avec des chaînes (symbole $).

D'autres typages existent :

• % pour typer en entier
• & pour typer en entier long
• @ pour typer en monétaire
• etc

Reportez vous à la documentation du Basic pour plus d'information.
.

Il est aussi possible d'influer sur l'index du tableau.
Cela peut s'avérer pratique pour rendre compatible certaines données dont l'accès à un chiffre précis est nécessaire.

Ainsi la syntaxe suivante :
permettra d'accéder plus simplement à un mois donné.

Les cas sont cependant peu nombreux, il est toujours préférable d'avoir un index à zéro.

L'option de déclaration Base
Rappelons que par défaut, le premier élément d'un tableau est l'élément 0.
Mais avec la ligne Option Base 1, le premier élément par défaut devient l'élément 1

Cette option est fortement déconseillé si vous voulez rester pleinement compatible avec l'extérieur.

Si vous tentez d'accéder à un élément du tableau qui n'existe pas, Basic vous renverra dans les cordes.
Un message "index out of bounds" se traduisant par un "index hors des limites" s'affichera.
Cela arrive souvent lorsque le tableau n'a pas été créé par vous et qu'il est renvoyé par un objet que vous interrogez.

Il faut donc connaître les dimensions du tableau avant d'en attaquer le contenu.
Deux instructions permettent de retourner l'index le plus petit et le plus grand.
LBound renvoie la valeur inférieure du tableau et UBound la valeur supérieure.

Ainsi, il est facile de parcourir un tableau pour le lire ou pour écrire dedans :


Il est possible également de parcourir un tableau avec l'instruction Each ... In :

Un tableau peut être agrandie grâce à l'instruction Redim.
Cela peut être pratique si sa taille a été sous estimée au départ où que vous ne connaissez pas la taille finale de la table mémoire.

Mais attention, car Redim vide le contenu du tableau.
Si vous voulez conserver les valeurs, ajouter l'option Preserve.

Petit exemple :

Faites l'expérience en enlevant l'instruction Preserve, le tableau sera alors vidé des 5 premiers éléments.

Avec l'instruction Array, on peut rapidement remplir un tableau.

Ainsi :
me donnera un tableau de 12 lignes dont l'index démarre à 0 et se termine à 11.

Autre exemple en reprenant notre tableau de mois pour le remplir avec Array :

Il est possible de réaliser des tableaux multi-dimensionnels.
Pour reprendre notre comparaison avec une feuille du tableur, nous n'avions jusqu'à présent qu'une seule colonne.
Un tableau peut bien sûr avoir plusieurs colonnes et plusieurs lignes.

Exemple avec cette forme :
Retranscription en Basic :
Pour obtenir les données, on indique les coordonnées colonne/ligne :


Ce principe est identique avec le module Base lorsque vous exécutez une requête SQL. Cette dernière vous renvoie un tableau du même genre.

Comme dans l'exemple précédent, vous pouvez également insérer des tableaux dans un tableau.
En déclarant le tableau principal comme "variable", les sous-tableaux sont imbriqués les uns à la suite des autres.

Pour récupérer une valeur :

Autre syntaxe possible en extrayant le sous-tableau :

Pour ce type de tableaux imbriqués, il n'existe pas de déclaration directe. Il faut passer par une boucle pour déclarer les sous-tableaux avec l'instruction DimArray.
Ainsi pour notre exemple, nous aurons le code suivant :



.

Dans cette feuille, j'ai besoin de transférer le contenu sélectionné dans une variable :

Dans une macro, il est possible en une ligne de récupérer cette sélection :

La variable récupérée sera sous la forme d'un tableau indexé de 0 à 2 et représentant les 3 lignes.
Puis de 3 sous-tableaux indexé de 0 à 3 représentant cette fois, les 4 colonnes.
Nous en revenons donc à l'accès sous cette forme :

Sans sélection, la démarche consiste à récupérer les objets successivement :
Classeur > Feuille > Plage > Données
Ce qui nous donne :

Le tableau oSelect se manipule de la même façon que précédemment.

NB : si les données sont sous forme de texte, il est préférable d'utiliser la propriété DataArray.

On s'inspire du code précédent et on fait la manipulation sur une autre feuille du classeur :

On voit qu'il est très simple de coller un tableau dès lors que la plage d'arrivée est dimensionnée correctement.

Pour ce 2e exemple, nous avons un nombre de lignes beaucoup plus important :

On privilégiera cette fois, un getCellRangeByPosition pour déterminer la taille du nouveau tableau.
C'est beaucoup plus simple puisque l'on peut intégrer directement les informations de dimension pour la plage de destination.

La transposition de tableau est une opération courante qu'on appelle aussi matrice transposée.
Elle est obtenue en échangeant les lignes et les colonnes :


Le code suivant fait la transposition du tableau A1:C2 en A1:B3 :

Il arrive d'avoir à faire des regroupements sur une 1ere colonne :

Attention : le tableau doit être trié sur la 1ere colonne.


On crée au départ un tableau de sortie aussi grand que celui en entrée.
Une fois le regroupement fait, on le redimensionne avant de le réintégrer dans la feuille.

NB : on rappelle que les données texte doivent être gérées avec la propriété DataArray.

Cette fois, les données de la seconde colonne sont éclatées dans des cellules distinctes :



NB : laisser un tableau avec un contenu vide donne une erreur #N/D lors du transfert sur la feuille.