Accueil > Documentation > Les balises XPX > GET

GET

La balise permet de fragmenter une chaine en fonction de séparateurs ou de caractères spéciaux.

3 utilisations sont possibles selon le découpage souhaité:

<GET FORMAT> pour découper selon un format prédéfini
<GET TOKEN> pour découper avec un séparateur
<GET TAG> pour découper des listes nom="value"

<get value="$val$" format="[separateur/variable]*">

Pour séparer une valeur en fonction de séparateurs connus, il faut utiliser l’attribut « format="séparateur/variable" ». Le découpage peut être effectué partiellement si le séparateur n'est pas trouvé.

Dans ce cas les variables non trouvées restent non définies.

L'attribut « value » vous permet d'indiquer la chaine de caractères que vous souhaitez découper.

<get value="2011-03-31" format="$annee$-$mois$-$jour$">

$annee$ prend alors la valeur 2011, $mois$ 03 et $jour$ 31.

<get value="siteweb@infocosme.com" format="$nom$@$companie$.com">

$nom$ prend la valeur siteweb et $companie$ a pour valeur infocosme.

<get value="val" token="[separateur]*" name="result" [option="null | notnull"]>

Pour fragmenter une string en un nombre de fragments dépendants de l’apparition des caractères séparateurs utilisez l'attribut « token="liste_des_caractères" ».

Vous pouvez aussi utiliser l’attribut « option="null/notnull" » pour préciser si vous voulez compter ou non les chaines vides (quand deux éléments séparateurs sont l’un à coté de l’autre). La valeur "null" prend en compte les chaines vides et la valeur "notnull’ ne les compte pas. Si option n'est pas précisé, la valeur par défaut est null.

L'attribut « "name" » vous permet de placer les fragments, obtenus par la découpe, dans une variable. Le premier fragment est ainsi obtenu dans la variable : $nom1$, le deuxième dans $nom2$ et ainsi de suite. La variable $nom$ (et $nom.count$) contient le nombre de fragments.

<get value="2011-03-31 11 :46 " name="date" token="- :">

Génère les variables suivantes :

$date$ =>5 (nombre de valeurs)

$date.count$ => 5 (nombre de valeurs)

$date1$ => 2011 (valeur du premier fragment)

$date2$ =>03 (valeur du second fragment)

…

$date5$ =>46 (valeur du cinquième fragment)

<get tag="...">

Permet de définir comme variables les valeurs définies dans la chaîne au format :

nom1="valeur1" [nom2="valeur2...]

Cette balise est utile notamment dans le cadre de lecture de fichiers XML (balises XPROC et XPATH), pour récupérer les attributs attachés à une balise XML.

<get tag="val1=\"12345\" val2=\"56789\"">

2 variables seront définies : val1 => 12345 val2 => 56789

Exemple avec balise XPROC :

<get tag="$xproc.attributes$">

GET

<get value="$val$" format="[separateur/variable]*">

<get value="val" token="[separateur]*" name="result" [option="null | notnull"]>

<get tag="...">

Télécharger

FAQ

Don