« Module:Outils » : différence entre les versions
Aller à la navigation
Aller à la recherche
(code de trim plus performant ; quand on multiplie par le nombre d'utilisations de cette fonction sur tout le wiki, le gain doit être intéressant) |
m (1 version importée) |
(Aucune différence)
|
Dernière version du 19 septembre 2023 à 16:06
La documentation pour ce module peut être créée à Module:Outils/doc
local Outils = { }
--[[
trim nettoie un paramètre non nommé (supprime les espaces et retours ligne au début et à la fin)
retourne nil si le texte est vide ou n'est pas du texte. Les nombres ne sont PAS considérés
comme du texte.
]]
function Outils.trim( texte )
if type( texte ) == 'string' and texte ~= '' then
-- http://lua-users.org/wiki/StringTrim
texte = texte:match( '^()%s*$' ) and '' or texte:match( '^%s*(.*%S)' )
if texte ~= '' then
return texte
end
end
return nil
end
--[[
validTextArg renvoit le premier paramètre chaine non vide
Paramètre :
1 - tableau contenant tous paramètres
2, ... - les noms des paramètres qui doivent êtres testés.
]]
function Outils.validTextArg( args, name, ... )
local texte = Outils.trim( args[name] )
if texte then
return texte
end
if select( '#', ... ) > 0 then
return Outils.validTextArg( args, ... )
end
return nil
end
--[[
notEmpty renvoie le premier paramètre non vide ou nul.
Paramètre :
1, ... - les variables qui doivent êtres testés.
]]
function Outils.notEmpty( var, ... )
local texte = Outils.trim( var )
if texte then
return texte
end
local tvar = type( var )
if tvar == 'table' then
local nextFunc = pairs( var ) -- n'utilise pas next car non défini par mw.loadData
if nextFunc( var ) ~= nil then
return var
end
elseif var == true or ( tvar == 'number' and var ~= 0 ) or tvar == 'function' then
return var
end
if select( '#', ... ) > 0 then
return Outils.notEmpty( ... )
end
end
--[[
extractArgs permet de récupérer les arguments du modèle,
ou la table transmise à la fonction par une autre fonction d'un module
Paramètre :
1 - un objet frame ou une table contenant les paramètres
]]
function Outils.extractArgs ( frame )
if type( frame.getParent ) == 'function' then
local args = frame:getParent().args
for k,v in pairs( frame.args ) do
args[k] = v;
end
return args
else
return frame
end
end
return Outils