https://baripedia.org/index.php?action=history&feed=atom&title=Module%3ATableBuilder%2FDocumentationModule:TableBuilder/Documentation - Historique des versions2026-06-17T14:43:59ZHistorique des versions pour cette page sur le wikiMediaWiki 1.38.6https://baripedia.org/index.php?title=Module:TableBuilder/Documentation&diff=7817&oldid=prevArthur : 1 version2014-01-13T22:02:24Z<p>1 version</p>
<p><b>Nouvelle page</b></p><div>{{Protection}}<br />
TableBuilder est un module qui applique aux fonctions de la [[mw:Extension:Scribunto/Lua reference manual/fr#Librairie Table|librairie Table]] une [[Désignation chaînée|interface fluide]]. Le code est ainsi à la fois plus concis et plus clair.<br />
<br />
Attention : ce module ne devrait être utilisé que pour des tables [[:mw:Extension:Scribunto/Lua_reference_manual/fr#s.C3.A9quence|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.<br />
<br />
== Utilisation ==<br />
Vous devez premièrement charger le module :<br />
<br />
{{code|lang=lua|code=local TableBuilder = require('Module:TableBuilder')}}<br />
<br />
Deuxièmement, vous devez instancier le tableau, avec <code>new</code> pour une nouvelle table, avec <code>set</code> pour une table existante, ou en clonant une table existante.<br />
<br />
{{code|lang=lua|code=local tab1 = TableBuilder.new()}}<br /><br />
{{code|lang=lua|code=TableBuilder.set(tab2)}}<br /><br />
{{code|lang=lua|code=local tab1 = TableBuilder.clone(tab3)}}<br />
<br />
Ensuite, vous pouvez utiliser les méthodes énumérées dans la [[mw:Extension:Scribunto/Lua reference manual/fr#Librairie Table|librairie Table]] (<code>insert</code>, <code>remove</code>, <code>sort</code>, <code>maxn</code>) ou une des fonctions spécifiques décrite ci-dessous.<br />
<br />
Enfin, vous devez concaténer la table en utilisant la méthode <code>concat()</code> :<br />
<br />
<code>tab.concat()</code><br />
<br />
== Fonction specifique ==<br />
* <code>minsert( ... )</code> — permet des inserts multiples, pour ajouter en une opération plusieurs éléments à la fin de la table. Les paramètres nil passés à la fonction sont ignorés.<br />
<br />
* <code>tinsert( table2, i, j )</code> — ajoute à la fin de la table les éléments <code>table2[i]</code> à <code>table2[j]</code>. La valeur par défaut de <code>i</code> est 1, et la valeur par défaut de <code>j</code> est la longueur de la table. Si <code>i</code> est plus grand que <code>j</code> aucun élément n'est ajouté.<br />
<br />
== clone == <br />
<code>TableBuilder.clone</code> duplique une table existante, de façon récursive. <br />
<br />
Contrairement à mw.clone, cette fonction ne clone pas la meta-table, mais utilise la meta-table de TableBuilder. Ceci permet notamment de modifier une table chargée par <code>mw.loadData</code>. <br />
<br />
Cette fonction ne devrait pas être utilisée sur la totalité de la table chargée par loadData (utiliser <code>require</code> sera plus économe en mémoire) mais sur une petite sous-table.<br />
<br />
== Exemples ==<br />
<syntaxhighlight lang="lua"><br />
local TableBuilder = require( 'Module:TableBuilder' )<br />
<br />
local date = { 'Cet exemple a été modifié le' }<br />
<br />
TableBuilder.set( date )<br />
<br />
date.insert( "4" )<br />
.insert( "2013" )<br />
.insert( 3, "septembre" )<br />
<br />
local time = TableBuilder.new()<br />
local heure, minute = "12", "8"<br />
local seconde<br />
<br />
time.minsert( "à", heure, "heures et", minute, "minutes", seconde, seconde and "secondes" )<br />
<br />
date.tinsert( time )<br />
<br />
local s = date.concat( ' ' ) .. "."<br />
--s = 'Cet exemple a été modifié le 4 septembre 2013 à 12 h et 8 minutes.'<br />
</syntaxhighlight><br />
<includeonly><br />
{{Projet Scribunto}}<br />
</includeonly><br />
<noinclude><br />
[[Catégorie:Documentation de module]]<br />
</noinclude></div>Arthur