Fonctions XPath, XQuery et XSLT

• 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'), 'Error: Price is too high')

Résultat : Retourne à l'environnement de traitement externe http://example.com/test#toohigh ainsi que la chaîne "Error: Price is too high".

Retourne 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

Retourne la valeur absolue du paramètre.

Exemple : abs(3.14)

Résultat : 3.14

Exemple : abs(-3.14)

Résultat : 3.14

Retourne l'entier le plus petit supérieur au paramètre num.

Exemple : ceiling(3.14)

Résultat : 4

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

Exemple : floor(3.14)

Résultat : 3

Ronde num de manière à ce qu'il soit le plus proche de l'entier.

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

Retourne la valeur de 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"

Retourne une chaîne à partir d'une séquence de code points.

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

Résultat : 'Thérèse'

Retourne une séquence de code points à partir 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, retourne -1. Si comp1 est égal à comp2, retourne 0. Si comp1 est supérieur à comp2, retourne 1. (Selon les règles de comparaison utilisées).

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

Résultat : 0

Retourne la concaténation des chaînes de caractères.

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

Résultat : 'XPath est FUN!'

Utilise le paramètre sep comme séparateur pour retourner la chaîne concaténée 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, commençant à 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 aucun paramètre string n'est fourni, retourne la longueur de la valeur de chaîne du noeud actuel.

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 aucun paramètre string n'est fourni, traite le noeud actuel.

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 le paramètre string 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, retourne true, sinon retourne false.

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

Résultat : true

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

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

Résultat : true

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

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

Résultat : false

Retourne la sous-chaine de caractères avant l'apparition de string2 dans string1.

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

Résultat : '12'

Retourne la sous-chaine de caractères après l'apparition de string2 dans string1.

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

Résultat : '10'

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

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

Résultat : true

Remplace le motif 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", "est", "fun")

Le paramètre est d'abord restauré à une valeur booléenne par la fonction boolean(). Si cette valeur booléenne est false, retourne true, 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 représentant l'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 représentant le 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 représentant le 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 représentant l'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 représentant la 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 l'année dans la valeur locale du paramètre.

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 jours 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

• 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 courant correspond au langage spécifié.

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

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

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

Retourne la position des éléments de la séquence é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 du paramètre item - supprimez l'élément spécifié 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")

Si la valeur du paramètre est une séquence vide, retourne true, 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 uniques.

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

Résultat : (1, 2, 3)

Retourne une nouvelle séquence construite à partir de l'élément spécifié par le 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 une séquence d'éléments à partir de la position spécifiée par le paramètre start, la longueur de la séquence est déterminé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)

Retourne la moyenne des valeurs des arguments

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

Résultat : 2

Retourne l'argument supérieur à d'autres arguments

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

Résultat : 3

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

Résultat : 'k'

Retourne l'argument inférieur à d'autres arguments

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

Résultat : 1

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

Résultat : 'a'

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

Retourner la position index du nœud traité en cours.

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

Résultat : sélection des trois premiers éléments book

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

Exemple : //book[last()]

Résultat : sélection de l'élément book dernier