`$array.stringify`¶

Description¶

Génère une représentation textuelle 2D d'un tableau.

La méthode gère deux cas de figure:

Les tableaux construits comme un tableau de tableaux, c.-à-d. un tableau ayant la forme [ [ 'a', 'b' ], [ 1, 2 ] ]
Les tableaux de maps, c.-à-d. un tableau contenant une série de maps

La méthode se charge alors de générer une représentation de la forme:

    col1 | col2
   ------+------
    a    | b
   ------+------
    1    | 2

Mise en forme de données SQL

La méthode $sql.mselect s'appuie sur $array.stringify lorsqu'elle est appelée avec une option de formatage text. Cela permet facilement de reprendre le résultat d'une requête SQL dans le log à des fins de debug par exemple.

Compatibilité

La mise en forme du tableau suppose que chaque caractère a une largeur fixe. La représentation du tableau doit donc utiliser une police à chasse fixe. Les emojis pouvant varier en taille, elles ne sont pas correctement supportées.

Syntaxe¶

$array.stringify( array [ , options ] )

Paramètres¶

array array

Tableau de valeurs. La table doit être une liste de listes, ce qui forme une table 2D.

options map

Options de mise en forme du tableau de sortie. Les options sont:

grid string

Valeur none/basic/full indiquant le type de grille souhaité. Par défaut, l'option est désactivée.

none : Aucune grille n'est affichée
basic : Grille minimale (séparateur de colonnes et de header, si activé)
full : Grille complète (comme basic, avec séparations de lignes en plus)

header array / string

Table 1D contenant les entêtes de colonnes à reprendre.

La propriété peut aussi prendre la valeur "inline". Dans ce cas, cela signifie que le header est à extraire de la première ligne de données.

Retour¶

Chaîne de caractère contenant la représentation 2D du tableau.

Exemple¶

Non disponible

$array.stringify¶