string-range

API Xml Pointer. Construit un ensemble d'intervalles sur les valeurs littéralles.

Syntaxe

string-range($ListeNoeuds as node()*, $Modele as string, $Position as number?, $Longueur as number?) as node()*

Description

L'API string-range construit un ensemble d'intervalles à partir de l'ensemble des noeuds passé en paramètre.

Seule la valeur littérale de l'élément est prise en compte i.e. sans tenir compte des balises imbriquées mais en conservant leur contenu.

Pour chaque noeud, le modèle donné par le second paramètre est recherché sur la valeur littéralle du noeud à partir de la position donnée par le troisième paramètre. Par défaut, la position est 1. La longueur de l'intervalle est donnée par le quatrième paramètre. Par défaut, la longueur est celle de la valeur littérale de l'élement.

Si le modèle est trouvé, l'intervalle est alors construit et il est ajouté à l'ensemble résultat. Sinon, rien n'est a jouté.

Rechercher la chaîne de caractères vide en tant que modèle équivaut à sélectionner l'intervalle défini par la position et la longueur données.

Exemple


<-- Selectionne les deuxiemes, troisiemes et quatriemes caracteres du nom de chaque employe. -->

$MaVariable=string-range(/descendant::Employe/Nom,2,3)

Voir aussi

end-point pour construire le point de fin. start-point pour construire le point de départ. range-to pour construire l'intervalle sur les éléments.