1 Fonctions de macro

Aperçu

Les fonctions de macro offrent la possibilité de personnaliser les valeurs de macro.

Parfois, une macro peut se résoudre en une valeur avec laquelle il n'est pas nécessairement facile de travailler. Elle peut être longue ou contenir une sous-chaîne spécifique d'intérêt que vous souhaitez extraire. C'est là que les fonctions de macro peuvent être utiles.

La syntaxe d'une fonction macro est :

{<macro>.<func>(<params>)}

où :

• <macro> - la macro à personnaliser (par exemple {ITEM.VALUE} ou {#LLDMACRO})
• <func> - la fonction à appliquer
• <params> - une liste de paramètres de fonction séparés par des virgules. Les paramètres doivent être entre guillemets s'ils commencent par '' '' (espace), " ou contiennent ), ,.

Par exemple :

{{TIME}.fmttime(format,time_shift)}
       {{ITEM.VALUE}.regsub(pattern, output)}
       {{#LLDMACRO}.regsub(pattern, output)}

Fonctions de macro prises en charge

Si une fonction est utilisée dans un emplacement pris en charge, mais appliquée à une macro ne prenant pas en charge les fonctions de macro, la macro est alors évaluée à 'INCONNU'.

Si pattern n'est pas une expression régulière correcte, la macro est évaluée à 'INCONNU' (à l'exception des macros de découverte de bas niveau où la fonction sera ignorée dans ce cas et la macro restera non développée)

Si une fonction de macro est appliquée à la macro dans des emplacements ne prenant pas en charge les fonctions de macro, la fonction est ignorée.

Exemples

Les façons dont les fonctions de macro peuvent être utilisées pour personnaliser les valeurs de macro sont illustrées dans les exemples suivants sur les valeurs reçues :

Affichage des valeurs complètes des éléments

Les valeurs longues des macros {ITEM.VALUE} et {ITEM.LASTVALUE} résolues sont tronquées à 20 caractères. Pour voir les valeurs complètes de ces macros, vous pouvez utiliser des fonctions de macro, par exemple :

{{ITEM.VALUE}.regsub("(.*)", \1)}
{{ITEM.LASTVALUE}.regsub("(.*)", \1)}