Module:TableBuilder/Documentation

TableBuilder est un module qui applique aux fonctions de la librairie Table une interface fluide. Le code est ainsi à la fois plus concis et plus clair.

Attention : ce module ne devrait être utilisé que pour des tables séquences, ou au pire des tables dont les éléments sont connu et limités. En effet, ajouter à la table un élément ayant pour index le nom d'une de ces fonctions remplace la fonction par cet élément.

Utilisation

Vous devez premièrement charger le module :

local TableBuilder = require('Module:TableBuilder')

Deuxièmement, vous devez instancier le tableau, avec new pour une nouvelle table, avec set pour une table existante.

local tab1 = TableBuilder.new()
TableBuilder.set(tab2)

Ensuite, vous pouvez utiliser les méthodes énumérées dans la librairie Table ou décrite ci-dessous.

Enfin, vous devez concaténer la table en utilisant la méthode concat() :

tab.concat()

Fonction specifique

• minsert( ... ) — permet des inserts multiples, pour ajouter en une opération plusieurs éléments à la fin de la talble. Les paramètres nil fournit à la fonctions sont ignorés.

• tinsert( table2, i, j ) — ajoute à la fin de la table les éléments table2[i] à table2[j]. La valeur par défaut de i est 1, et la valeur par défaut de j est la longueur de la table. Si i est plus grand que j aucun élément n'est ajouté.

Exemples

local TableBuilder = require( 'Module:TableBuilder' )

local date = { 'Cet exemple à été modifiè le' }

TableBuilder.set( date )

date.insert( "4" )
    .insert( "2013" )
    .insert( 3, "septembre" )

local time = TableBuilder.new()
local heure, minute = "12", "8"
local seconde

time.minsert( "à", heure, "heures et", minute, "minutes", seconde, seconde and "secondes" )

date.tinsert( time )

local s = date.concat( ' ' ) .. "."
--s = 'Cet exemple à été modifiè le 4 septembre 2013 à 12 h et  8 minutes.'