Assistant d'expression XPath - options de référence de fonctions

Lorsque vous créez une expression XPath, vous pouvez utiliser les options de référence de fonctions pour spécifier ensemble de noeuds, booléen, chaîne, nombre, XSLT et fonctions définies par l'utilisateur. Les fonctions sont utilisées pour rendre XPath encore plus puissant.

Certaines fonctions nécessitent des informations pour être utilisées. Ces informations sont transmises sous la forme de paramètres insérés entre des parenthèses ( ).

Pour accéder aux options de référence de fonction, cliquez sur l'onglet Référence dans l'assistant d'expression XPath.

Fonctions Ensemble de noeuds

Vous pouvez recourir aux fonctions suivantes pour utiliser des ensembles de noeuds.

Fonction Retours
count( )  Nombre de noeuds dans un ensemble de noeuds.
last( ) Taille (c'est-à-dire le nombre de noeuds dans) la liste de noeuds de contexte.
position Position d'un noeud dans un ensemble de noeuds, dans l'ordre du document.  Par exemple, position( ) = 2 renvoie le second élément d'un ensemble de noeuds.
id(string Ensemble de noeuds contenant tous les éléments du document avec la string spécifiée.
local-name(node set ) Nom du premier noeud dans node set. Sans argument, c'est le nom local du noeud de contexte qui est renvoyé.
namespace uri( ) URI espace de nom du noeud de contexte.
name( )  Nom du noeud de contexte, y compris le préfixe d'espace de nom.

Fonctions booléennes

Vous pouvez utiliser ces fonctions pour les mathématiques booléennes.

Fonction Retours
boolean ( )  Evalue si une expression est true ou false.
false ( ) Renvoie toujours false
true ( ) Renvoie toujours true
lang ( ) Renvoie true ou false selon que le langage du noeud de contexte spécifié par les attributs xml:lang est le même langage que celui spécifié par la chaîne d'arguments ou un sous-langage.
not ( ) Inverse la valeur de l'expression booléenne : true si l'expression est false, dans le cas contraire false.

Fonctions de chaîne

Vous pouvez recourir aux fonctions suivantes pour utiliser des chaînes.

Fonctions Retours
concat( ) Concaténation de ses arguments. Par exemple, concat ('This is', ' ', 'my string') renvoie "This is my string"
contains( )  Indication signifiant si une chaîne contient le contenu d'une seconde chaîne. Par exemple, contains ("This is my string", "is my") renvoie true, car la chaîne "This is my string" contient la chaîne "is my".
normalize-space( ) Chaîne d'arguments avec normalisation des espaces blancs en enlevant les espaces blancs d'interlignage et de fin de ligne et en remplaçant les séquences d'espaces blancs par un espace unique.
starts-with( ) Indication signalant si une chaîne commence par le contenu d'une seconde chaîne. Par exemple, starts-with ("This is my string", "This") renvoie true, puisque la chaîne "This is my string" commence par la chaîne "This" .
string( ) Convertit toute valeur en chaîne.
string-length( ) Nombre de caractères contenus dans la chaîne, y compris les espaces.
substring( ) Prend un nombre spécifié de caractères dans une chaîne. Par exemple, substring ('This is my string' ,9, 2 ) renvoie my puisque nous avons demandé de commencer au neuvième caractère et de prendre deux caractères.
substring-after( ) Tous les caractères après un certain caractère. Par exemple, substring-after ('This is my string','s' ) renvoie tous les caractères après la première occurrence de la lettre "s", en d'autres termes "is my string".
substring-before( ) Tous les caractères avant un certain caractère. Par exemple, substring-before ('This is my string','s' ) renvoie tous les caractères avant la première occurrence de la lettre "s", en d'autres termes "Thi".
translate (string, to-match, replace-with ) Chaîne string avec toutes les occurrences de la sous-chaîne to-match remplacée par la chaîne replace-with .

Fonctions de nombre

Vous pouvez utiliser ces fonctions pour traiter les nombres.

Fonction Retours
ceiling ( ) Valeur de l'expression arrondie à l'entier supérieur.
floor ( ) Valeur de l'expression arrondie à l'entier inférieur.
round ( ) Valeur de l'expression arrondie à l'entier le plus proche.
number ( ) Convertit le texte PCDATA en valeur numérique.
sum ( ) Rassemble toutes les valeurs numériques dans un ensemble de noeuds.

Fonctions XSLT

XSLT utilise fortement la syntaxe XPath et prend en charge toutes les fonctions définies dans XPath. En outre, il définit dix fonctions supplémentaires.    

Fonction Retours
current( ) Un ensemble de noeuds contenant un noeud unique, le noeud en cours.
document( ) Autorise l'accès aux documents XML autres que le document source principal.
element-available( )  true si l'argument identifie un élément XSLT reconnu par le processeur, false dans le cas contraire.
format-number (number x, string pattern ) Convertit number x en une chaîne utilisant string pattern spécifié par le second argument.
function-available( ) true si l'argument identifie une fonction dans la bibliothèque de fonctions du processeur, false dans le cas contraire.
generate-id( ) Chaîne pouvant être utilisée comme valeur d'un attribut de type ID.
key (string keyName, object value ) Ensemble de noeuds contenant tous les noeuds du document source ayant une clé avec le nom donné par le premier argument et la valeur donnée par le second argument.
unparsed-entity-uri( ) URI de l'entité non analysée syntaxiquement avec le nom spécifié déclaré dans la DTD du document source.
system-property( ) Valeur de la propriété nommée.

Défini par l'utilisateur

Toute fonction définie par l'utilisateur que vous pouvez utiliser dans votre expression XPath sera répertoriée ici.

Tâches associées
Création d'expressions XPath
Référence associée
Assistant d'expression XPath - options de référence de syntaxe

Retour d'informations