Fonctions XSLT, XPath et XQuery

• fn:base-uri()
• fn:base-uri(node)

• fn:error()
• fn:error(error)
• fn:error(error,description)
• fn:error(error,description,error-object)

Exemple : error(fn:QName('http://example.com/test', 'err:toohigh'), 'Erreur : Le prix est trop élevé')

Résultat : renvoie à l'environnement de traitement externe http://example.com/test#toohigh ainsi que la chaîne "Erreur : Le prix est trop élevé".

Renvoie la valeur numérique du paramètre. Le paramètre peut être une valeur booléenne, une chaîne ou un ensemble de nœuds.

Exemple : number('100')

Résultat : 100

Retournez la valeur absolue du paramètre.

Exemple : abs(3.14)

Résultat : 3.14

Exemple : abs(-3.14)

Résultat : 3.14

Retournez le plus petit entier supérieur au paramètre num.

Exemple : ceiling(3.14)

Résultat : 4

Retournez le plus grand entier non supérieur au paramètre num.

Exemple : floor(3.14)

Résultat : 3

Arrondissez le paramètre num à l'entier le plus proche.

Exemple : round(3.14)

Résultat : 3

Exemple : round-half-to-even(0.5)

Résultat : 0

Exemple : round-half-to-even(1.5)

Résultat : 2

Exemple : round-half-to-even(2.5)

Résultat : 2

Retournez la valeur en chaîne du paramètre. Le paramètre peut être un nombre, une valeur logique ou un ensemble de nœuds.

Exemple : string(314)

Résultat : "314"

Retournez une chaîne en fonction de la séquence de points de code.

Exemple : codepoints-to-string(84, 104, 233, 114, 232, 115, 101)

Résultat : 'Thérèse'

Retournez une séquence de points de code en fonction de la chaîne.

Exemple : string-to-codepoints("Thérèse")

Résultat : 84, 104, 233, 114, 232, 115, 101

• fn:compare(comp1,comp2)
• fn:compare(comp1,comp2,collation)

Si comp1 est inférieur à comp2, retournez -1. Si comp1 est égal à comp2, retournez 0. Si comp1 est supérieur à comp2, retournez 1. (Selon les règles de correspondance utilisées).

Exemple : compare('ghi', 'ghi')

Résultat : 0

Retourne la concaténation des chaînes.

Exemple : concat('XPath ','is ','FUN!')

Résultat : 'XPath is FUN!'

Utilise le paramètre sep en tant que séparateur pour retourner une chaîne composée de la concaténation des paramètres string.

Exemple : string-join(('We', 'are', 'having', 'fun!'), ' ')

Résultat : ' We are having fun! '

Exemple : string-join(('We', 'are', 'having', 'fun!'))

Résultat : 'Wearehavingfun!'

Exemple : string-join((), 'sep')

Résultat : ''

• fn:substring(string,start,len)
• fn:substring(string,start)

Retourne une sous-chaîne de la longueur spécifiée, à partir de la position start. L'index du premier caractère est 1. Si le paramètre len est omis, retourne la sous-chaîne de la position start à la fin de la chaîne.

Exemple : substring('Beatles',1,4)

Résultat : 'Beat'

Exemple : substring('Beatles',2)

Résultat : 'eatles'

• fn:string-length(string)
• fn:string-length()

Retourne la longueur de la chaîne spécifiée. Si le paramètre string n'est pas spécifié, retourne la longueur de la valeur de chaîne du noeud courant.

Exemple : string-length('Beatles')

Résultat : 7

• fn:normalize-space(string)
• fn:normalize-space()

Supprime les espaces au début et à la fin de la chaîne spécifiée, remplace toutes les séquences d'espaces internes par un seul espace et retourne le résultat. Si le paramètre string n'est pas spécifié, traite le noeud courant.

Exemple : normalize-space(' The　　　XML ')

Résultat : 'The XML'

Convertit le paramètre string en majuscules.

Exemple : upper-case('The XML')

Résultat : 'THE XML'

Convertit la chaîne de caractères en minuscules.

Exemple : lower-case('The XML')

Résultat : 'the xml'

Remplacez string2 par string3 dans string1.

Exemple : translate('12:30','30','45')

Résultat : '12:45'

Exemple : translate('12:30','03','54')

Résultat : '12:45'

Exemple : translate('12:30','0123','abcd')

Résultat : 'bc:da'

Exemple : escape-uri("http://example.com/test#car", true())

Résultat : "http%3A%2F%2Fexample.com%2Ftest#car"

Exemple : escape-uri("http://example.com/test#car", false())

Résultat : "http://example.com/test#car"

Exemple : escape-uri ("http://example.com/~bébé", false())

Résultat : "http://example.com/~b%C3%A9b%C3%A9"

Si string1 contient string2, renvoie true, sinon renvoie false.

Exemple : contains('XML','XM')

Résultat : true

Si string1 commence par string2, renvoie true, sinon renvoie false.

Exemple : starts-with('XML','X')

Résultat : true

Si string1 se termine par string2, renvoie true, sinon renvoie false.

Exemple : ends-with('XML','X')

Résultat : false

Renvoie le sous-chaîne précédant l'apparition de string2 dans string1.

Exemple : substring-before('12/10','/')

Résultat : '12'

Retourne la sous-chaine qui suit string2 dans string1.

Exemple : substring-after('12/10','/')

Résultat : '10'

Retourne true si le paramètre string correspond au schéma spécifié, sinon retourne false.

Exemple : matches("Merano", "ran")

Résultat : true

Remplace le schéma spécifié par le paramètre replace et retourne le résultat.

Exemple : replace("Bella Italia", "l", "*")

Résultat : 'Be**a Ita*ia'

Exemple : replace("Bella Italia", "l", "")

Résultat : 'Bea Itaia'

Exemple : tokenize("XPath is fun", "\s+")

Résultat : ("XPath", "is", "fun")

Premièrement, le paramètre est restauré à une valeur booléenne par la fonction boolean().

Retourne true si la valeur booléenne est false, sinon retourne true.

Exemple : not(true())

Résultat : false

Retourne la valeur booléenne true.

Exemple : true()

Résultat : true

Retourne la valeur booléenne false.

Exemple : false()

Résultat : false

Retourne l'entier de la partie année de la valeur locale du paramètre.

Exemple : year-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Résultat : 2005

Retourne l'entier de la partie mois de la valeur locale du paramètre.

Exemple : month-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Résultat : 01

Retourne l'entier de la partie jour de la valeur locale du paramètre.

Exemple : day-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Résultat : 10

Retourne l'entier de la partie heure de la valeur locale du paramètre.

Exemple : hours-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Résultat : 12

Retourne l'entier de la partie minute de la valeur locale du paramètre.

Exemple : minutes-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Résultat : 30

Retourne le nombre décimal de secondes de la valeur locale du paramètre.

Exemple : seconds-from-dateTime(xs:dateTime("2005-01-10T12:30:00-04:10"))

Résultat : 0

Retourne l'entier représentant la partie année du paramètre local.

Exemple : year-from-date(xs:date("2005-04-23"))

Résultat : 2005

Retourne l'entier représentant la partie mois du paramètre local.

Exemple : month-from-date(xs:date("2005-04-23"))

Résultat : 4

Retourne l'entier représentant la partie jour du paramètre local.

Exemple : day-from-date(xs:date("2005-04-23"))

Résultat : 23

Retourne l'entier représentant la partie heures du paramètre local.

Exemple : hours-from-time(xs:time("10:22:00"))

Résultat : 10

Retourne l'entier représentant la partie minutes du paramètre local.

Exemple : minutes-from-time(xs:time("10:22:00"))

Résultat : 22

Retourne l'entier représentant la partie secondes du paramètre local.

Exemple : seconds-from-time(xs:time("10:22:00"))

Résultat : 0

Si le paramètre timezone est vide, retourne le dateTime sans timezone.

Sinon, retourne le dateTime avec timezone.

Si le paramètre timezone est vide, retourne la date sans timezone.

Sinon, retourne la date avec timezone.

Si le paramètre timezone est vide, retourne le time sans timezone.

Sinon, retourne la date avec le fuseau horaire.

• fn:name()
• fn:name(nodeset)

• fn:local-name()
• fn:local-name(nodeset)

• fn:namespace-uri()
• fn:namespace-uri(nodeset)

Retourne true si le langage du noeud actuel correspond au langage spécifié.

Exemple : Lang("en") est vrai pour <p xml:lang="en">...</p>

Exemple : Lang("de") est faux pour <p xml:lang="en">...</p>

• fn:root()
• fn:root(node)

Retourne la position de l'élément dans la séquence de l'élément égale au paramètre searchitem.

Exemple : index-of ((15, 40, 25, 40, 10), 40)

Résultat : (2, 4)

Exemple : index-of (("a", "dog", "and", "a", "duck"), "a")

Résultat (1, 4)

Exemple : index-of ((15, 40, 25, 40, 10), 18)

Résultat : ()

Retourne une nouvelle séquence construite à partir de l'élément paramètre - supprimez l'élément à la position spécifiée par le paramètre position.

Exemple : remove(("ab", "cd", "ef"), 0)

Résultat : ("ab", "cd", "ef")

Exemple : remove(("ab", "cd", "ef"), 1)

Résultat : ("cd", "ef")

Exemple : remove(("ab", "cd", "ef"), 4)

Résultat : ("ab", "cd", "ef")

Retourne true si la valeur du paramètre est une séquence vide, sinon retourne false.

Exemple : empty(remove(("ab", "cd"), 1))

Résultat : false

Retourne true si la valeur du paramètre n'est pas une séquence vide, sinon retourne false.

Exemple : exists(remove(("ab"), 1))

Résultat : false

Retourne les valeurs différentes.

Exemple : distinct-values((1, 2, 3, 1, 2))

Résultat : (1, 2, 3)

Retourne une nouvelle séquence construite à partir du paramètre item, en insérant la valeur spécifiée par le paramètre inserts à la position spécifiée par le paramètre pos.

Exemple : insert-before(("ab", "cd"), 0, "gh")

Résultat : ("gh", "ab", "cd")

Exemple : insert-before(("ab", "cd"), 1, "gh")

Résultat : ("gh", "ab", "cd")

Exemple : insert-before(("ab", "cd"), 2, "gh")

Résultat : ("ab", "gh", "cd")

Exemple : insert-before(("ab", "cd"), 5, "gh")

Résultat : ("ab", "cd", "gh")

Retourne l'ordre inversé des éléments spécifiés.

Exemple : reverse(("ab", "cd", "ef"))

Résultat : ("ef", "cd", "ab")

Exemple : reverse(("ab"))

Résultat : ("ab")

Retourne la séquence d'éléments à partir de l'indice spécifié par le paramètre start, avec une longueur spécifiée par le paramètre len.

La position du premier élément est 1.

Exemple : subsequence(($item1, $item2, $item3,...), 3)

Résultat : ($item3, ...)

Exemple : subsequence(($item1, $item2, $item3, ...), 2, 2)

Résultat : ($item2, $item3)

Renvoie la moyenne des valeurs des paramètres.

Exemple : avg((1,2,3))

Résultat : 2

Renvoie le paramètre supérieur à d'autres paramètres.

Exemple : max((1,2,3))

Résultat : 3

Exemple : max(('a', 'k'))

Résultat : 'k'

Renvoie le paramètre inférieur à d'autres paramètres.

Exemple : min((1,2,3))

Résultat : 1

Exemple : min(('a', 'k'))

Résultat : 'a'

• fn:collection()
• fn:collection(string)

Retourner l'index positionnel du nœud en cours de traitement.

Exemple : //book[position()<=3]

Résultat : sélectionner les trois premiers éléments book

Retourner le nombre d'éléments dans la liste des nœuds traités.

Exemple : //book[last()]

Résultat : sélectionner le dernier élément book