Macro .foreach

Cette macro permet une itération des parties d'une chaîne divisée par un délimiteur utilisant la variable locale %CurrentPart% spéciale.

.foreach_part (entrée [,"délimiteur" [,en-tête [,fin]]])
	résultat
.next[(séparateur)]

Les paramètres suivants sont disponibles :

Paramètre	Description
entrée	Spécifie le texte sur lequel effectuer l'itération. Type : Template simple
délimiteur	Spécifie la sous-chaîne qui divise l'entrée en parties. Vous pouvez spécifier plusieurs caractères, et mêmes des plages de caractères. Par exemple `[A-Z]` spécifie que n'importe quelle lettre majuscule peut agir comme délimiteur. Par défaut le délimiteur est défini à `' -_,\t'` (espace, tiret, trait de soulignement, virgule, ou tabulation). Remarque : Le délimiteur doit être encadré d'apostrophes s'il contient un espace. Type : Texte
en-tête	[facultatif] Spécifie le texte à générer avant le résultat, sauf s'il n'y a pas de résultat. Type : Texte
fin	[facultatif] Spécifie le texte à générer après le résultat, sauf s'il n'y a pas de résultat. Type : Texte
résultat	Spécifie le texte à produire pour chaque partie de l'entrée. Type : Template complexe
séparateur	[facultatif] Spécifie le texte à générer entre chaque partie du résultat. Type : Texte

Par exemple :

Exemples
Ce template est appliqué à `My class` : .foreach_part (%Name%) %.FU:CurrentPart% .next Résultat : MyClass
Ce template est appliqué à `My class` : .foreach_part (%Name%,' -_',tbl_) %.L:CurrentPart% .next(_) Résultat : tbl_my_class
Ce template est appliqué à `MyClass` : .foreach_part (%Name%,[A-Z]) %.L:CurrentPart% .next(-) Résultat : my-class

Exemples

Ce template est appliqué à My class :

.foreach_part (%Name%)
%.FU:CurrentPart%
.next

Résultat :

MyClass

Ce template est appliqué à My class :

.foreach_part (%Name%,' -_',tbl_)
%.L:CurrentPart%
.next(_)

Résultat :

tbl_my_class

Ce template est appliqué à MyClass :

.foreach_part (%Name%,[A-Z])
%.L:CurrentPart%
.next(-)

Résultat :

my-class

Macro .foreach_part