Certaines fonctions ont besoin d'informations pour fonctionner. 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.
Vous pouvez utiliser les fonctions suivantes pour manipuler des ensembles de noeuds.
| Fonction | Retour |
|---|---|
| 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(chaîne) | Ensemble de noeuds contenant tous les éléments du document avec la chaîne spécifiée. |
| local-name(ensemble de noeuds ) | Nom du premier noeud dans ensemble de noeuds. Sans argument, la fonction renvoie le nom local du noeud de contexte. |
| namespace uri( ) | URI d'espace de noms du noeud de contexte. |
| name( ) | Nom du noeud de contexte, y compris le préfixe d'espace de noms. |
Vous pouvez utiliser ces fonctions pour les opérations booléennes.
| Fonction | Retour |
|---|---|
| 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 passée en argument ou un sous-langage de ce langage. |
| not ( ) | Inverse la valeur de l'expression booléenne : true si l'expression est false, false si l'expression est true. |
Vous pouvez utiliser les fonctions suivantes pour manipuler des chaînes.
| Fonction | Retour |
|---|---|
| concat( ) | Concaténation de ses arguments. Par exemple, concat ('Ceci est', ' ', 'une chaîne') renvoie "Ceci est une chaîne" |
| contains( ) | Indique si une chaîne contient le contenu d'une seconde chaîne. Par exemple, contains ("Ceci est une chaîne", "est une") renvoie true, car la chaîne "Ceci est une chaîne" contient effectivement la chaîne "est une". |
| normalize-space( ) | Chaîne passée en argument, normalisée par la suppression de tous les blancs de début et de fin et par remplacement de chaque série de caractères blancs par un seul espace. |
| starts-with( ) | Indique si une chaîne commence par le contenu d'une seconde chaîne. Par exemple, starts-with ("Ceci est une chaîne", "Ceci") renvoie true, car la chaîne "Ceci est une chaîne" commence effectivement par la chaîne "Ceci". |
| string( ) | Convertit une valeur en chaîne. |
| string-length( ) | Nom de caractères dans la chaîne, y compris les espaces. |
| substring( ) | Prend un nombre spécifié de caractères dans une chaîne. Par exemple, substring ('Ceci est une chaîne' ,10, 3 ) renvoie une, car on demande à commencer au dixième caractère et à prendre trois caractères. |
| substring-after( ) | Tous les caractères après un caractère spécifique. Par exemple, substring-after ('Ceci est une chaîne','i' ) renvoie tous les caractères après la première occurrence de la lettre "i", ce qui donne "est une chaîne". |
| substring-before( ) | Tous les caractères avant un caractère spécifique. Par exemple, substring-before ('Ceci est une chaîne','i' ) renvoie tous les caractères avant la première occurrence de la lettre "i", ce qui donne "Cec". |
| translate (chaîne, à-chercher, remplacement ) | La chaîne avec toutes les occurrences de la sous-chaîne à-chercher remplacées par la sous-chaîne remplacement . |
Vous pouvez utiliser ces fonctions pour manipuler des nombres.
| Fonction | Retour |
|---|---|
| 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 ( ) | Somme arithmétique de toutes les valeurs numériques dans un ensemble de noeuds. |
XSLT fait un usage intensif de la syntaxe XPath et prend en charge toutes les fonctions définies dans XPath. Il définit dix fonctions supplémentaires.
| Fonction | Retour |
|---|---|
| current( ) | Un ensemble de noeuds contenant un seul noeud, le noeud en cours. |
| document( ) | Permet d'accéder 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 (nombre x, masque de chaîne ) | Convertit le nombre x en une chaîne en utilisant le masque de chaîne spécifié par le second argument. |
| function-available( ) | true si l'argument identifie une fonction présente 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 (chaîne nomClé, objet valeur ) | 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 interprétée ayant le nom spécifié et déclarée dans la DTD du document source. |
| system-property( ) | Valeur de la propriété nommée. |
Toute fonction définie par l'utilisateur que vous pouvez utiliser dans votre expression XPath est répertoriée ici.