Latest web development tutorials

XPath, XQuery et XSLT fonctions

Le manuel de référence ci-dessous définit les fonctions XPath 2.0, XQuery 1.0 et XSLT 2.0.


Fonction Manuel de référence

note La fonction namespace prefix pour fn par défaut:

note Fonction URI est: http://www.w3.org/2005/xpath-functions

fonction d'accès

nom explication
fn: nom-noeud (node) Renvoie le noeud nom noeud de paramètre.
fn: nilled (noeud) Retourne si de rejeter la valeur booléenne de noeud d'argument.
fn: données (item.item, ...) Accepter la séquence du projet et renvoie la séquence de valeurs atomiques.
  • fn: base-uri ()
  • fn: base-uri (noeud)
Renvoie la valeur de l'attribut de base-uri actuelle spécifie le ou les noeuds.
fn: document uri (noeud) Renvoie la valeur du document-uri noeud propriété spécifiée.

Erreurs et fonctions de suivi

nom explication
  • fn: error ()
  • fn: erreur (erreur)
  • fn: erreur (erreur, description)
  • fn: erreur (erreur, description, erreur-objet)

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

Résultats: retour http://example.com/test#toohigh~~number=plural et chaîne à l'environnement de traitement externe "Erreur: Le prix est trop élevé".

fn: trace (valeur, étiquette) Il est utilisé pour interroger debug.

valeurs Fonctions liées

nom explication
fn: nombre (arg)

Renvoie la valeur du paramètre. Paramètre est une valeur, une chaîne ou ensemble de nœuds booléenne.

Exemples: nombre ( '100')

Résultats: 100

fn: abs (num)

Renvoie la valeur absolue du paramètre.

Exemples: abs (3.14)

Résultats: 3.14

Exemples: abs (-3.14)

Résultats: 3.14

fn: plafond (num)

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

Exemples: plafond (3.14)

Résultats: 4

fn: étage (num)

Renvoie le plus grand entier non supérieur à paramètre num.

Exemples: plancher (3.14)

Résultats: 3

fn: round (num)

L'argument num arrondi à l'entier le plus proche.

Exemples: ronde (3.14)

Résultats: 3

fn: ronde demi-à-pair ()

Exemples: ronde demi-à-pair (0,5)

Résultats: 0

Exemples: ronde demi-à-pair (1,5)

Résultats: 2

Exemples: ronde demi-à-pair (2,5)

Résultats: 2

Fonctions sur les chaînes

nom explication
fn: string (arg)

Renvoie la valeur de chaîne du paramètre. Les arguments peuvent être des nombres, des valeurs logiques ou ensemble de noeuds.

Exemples: string (314)

Résultat: le "314"

fn: codepoints-à-string (int, int, ...)

Selon la séquence de point de code renvoie une chaîne.

Exemples: codepoints-à-chaîne (84, 104, 233, 114, 232, 115, 101)

Résultats: «Thérèse»

fn: string à codepoints (string)

Selon le point de code séquence de retour de chaîne.

Exemples: Chaîne à codepoints ( "Thérèse")

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

fn: codepoint-égal (COMP1, COMP2) Selon la comparaison du point de code Unicode, si la valeur est égale à la valeur de comp2 comp1 Renvoie true. (Http://www.w3.org/2005/02/xpath-functions/collation/codepoint), sinon il retourne faux.
  • fn: comparer (COMP1, COMP2)
  • fn: comparer (COMP1, COMP2, collation)

Si comp1 moins de comp2, -1 est renvoyé. Si comp1 égale comp2, 0 est renvoyé. Si COMP1 supérieure à comp2, 1 est renvoyé. (Selon les règles utilisées par le contrôle).

Exemple: comparer ( «ghi», «ghi»)

Résultats: 0

fn: concat (string, string, ...)

Renvoie la concaténation de chaîne.

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

Résultats: 'XPath est FUN!

fn: string-jointure ((string, string, ...), septembre)

Utilisez septembre comme argument de delimiter pour retourner la chaîne de paramètres de chaîne après la couture.

Exemples: string-rejoindre ( '! Fun' ( 'Nous', 'sont', 'ayant',), '')

Résultats: «nous nous amusons!

Exemples: string-rejoindre ( '! Fun' ( 'Nous', 'sont', 'ayant',))

Résultats: 'Wearehavingfun!'

Exemples: string-joindre ((), 'septembre')

Résultats: ''

  • fn: substring (chaîne, début, len)
  • fn: substring (chaîne, début)

Renvoie la sous-chaîne à partir de la position de départ du début de la longueur spécifiée. Indice du premier caractère est 1. Si vous omettez l'argument len ​​de la position de début à la fin d'une chaîne est retournée.

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

Résultats: 'Beat'

Exemples: substring ( 'Beatles', 2)

Résultats: 'eatles'

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

Renvoie la longueur de la chaîne. S'il n'y a pas d'argument de chaîne, la longueur de la valeur de chaîne du nœud courant est retourné.

Exemples: string-length ( 'Beatles')

Résultats: 7

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

Retirez le début et la fin de la chaîne spécifiée vide, vide et tout remplacé par une série de interne et renvoie le résultat. S'il n'y a pas d'argument de chaîne, le processus du noeud courant.

Exemples: normalize-space ( 'Le XML')

Résultats: 'Le XML'

fn: normalize-unicode () Mise en œuvre de normalisation Unicode.
fn: majuscules (string)

L'argument de chaîne en majuscules.

Exemples: majuscules ( 'Le XML')

Résultats: 'THE XML'

fn: minuscule (string)

L'argument de chaîne convertie en minuscules.

Exemples: minuscules ( 'Le XML')

Résultats: 'xml'

fn: translate (string1, string2, string3)

Le string1 dans chaîne2 remplacé string3.

Exemples: traduire ('12: 30 ',' 30 ',' 45 ')

Résultats: '12: 45 '

Exemples: traduire ('12: 30 ',' 03 ',' 54 ')

Résultats: '12: 45 '

Exemples: traduire ('12: 30 ',' 0123 ',' abcd ')

Résultats: 'bc: da'

fn: escape-uri (stringURI, esc-res)

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

Résultats: "http% 3A% 2F% 2Fexample.com% 2Ftest # voiture"

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

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

Exemples: escape-uri ( "http://example.com/~bebe", false ())

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

fn: contient (string1, string2)

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

Exemples: contient ( «XML», «XM»)

Résultats: true

fn: starts-with (string1, string2)

Si string1 commence par string2, il retourne vrai, sinon retourne false.

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

Résultats: true

fn: finit-avec (string1, string2)

Si string1 avec la fin de l'string2 renvoie true, sinon il retourne faux.

Exemples: extrémités-avec ( 'XML', 'X')

Résultats: faux

fn: substring-before (string1, string2)

Renvoie une sous-string1 string2 comparaître devant.

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

Résultats: '12 '

fn: substring-après (string1, string2)

Renvoie une sous-chaîne de string1 string2 apparaissent plus tard.

Exemples: substring-après ('12 / 10 ',' / ')

Résultats: '10 '

fn: matchs (string, motif)

Si la chaîne correspond au modèle spécifié, il retourne vrai, sinon retourne false.

Exemples: matchs ( «Merano», «couru»)

Résultats: true

fn: remplacer (string, modèle, remplacer)

Le mode spécifié est remplacé remplacer le paramètre et renvoie le résultat.

Exemples: remplacer ( "Bella Italia", "l", "*")

Résultats: «Soyez ** un Ita * ia '

Exemples: remplacer ( "Bella Italia", "l", "")

Résultats: Bea Itaia '

fn: tokenize (string, motif)

Exemples: tokenize ( "XPath est amusant", "\ s +")

Résultats :( "XPath", "est", "fun")

fonction anyURI pour

nom explication
fn: resolve-uri (relative, base)

Fonctions de valeurs booléennes

nom explication
fn: boolean (arg) Renvoie une valeur numérique, chaîne, ou ensemble de nœuds booléenne.
fn: non (arg)

Tout d'abord, la fonction booléenne () pour restaurer les paramètres d'une valeur booléenne. Si la valeur booléenne est fausse, elle renvoie true, sinon il retourne vrai.

Exemple: non (true ())

Résultats: faux

fn: true ()

Renvoie une valeur booléenne true.

Exemples: true ()

Résultats: true

fn: false ()

Renvoie une fausse valeur booléenne.

Exemples: false ()

Résultats: faux

Fonctions liées à la durée, la date et l' heure

Date, heure, durée de fonction d'extraction des composants

nom explication
fn: dateTime (date, heure) Les arguments à ce jour et l'heure.
fn: années-de-durée (datetimedur) La partie entière de l'année de la valeur de retour d'une notation standard pour représenter les mots.
fn: mois-de-durée (datetimedur) Renvoie la partie entière des valeurs de paramètres du mois, une notation standard pour représenter les mots.
fn: jours-de-durée (datetimedur) Renvoie la partie entière des valeurs de paramètres de la journée, une notation standard pour représenter les mots.
fn: heures-de-durée (datetimedur) Renvoie la partie entière des valeurs de paramètres de l'heure, la notation standard pour représenter les mots.
fn: minutes-de-durée (datetimedur) Renvoie la partie entière du procès-verbal des valeurs de paramètres, la notation standard pour représenter les mots.
fn: secondes-de-durée (datetimedur) Renvoie la partie décimale du nombre de minutes de valeurs de paramètres, une notation standard pour représenter les mots.
fn: année-from-dateTime (datetime)

Renvoie les valeurs des paramètres d'entier dans la section locale.

Exemples: année de-dateTime (xs: dateTime ( "2005-01-10T12: 30-04: 10"))

Résultats: 2005

fn: mois-from-dateTime (datetime)

Renvoie la partie entière des valeurs mensuelles de paramètres locaux.

Exemples: mois de-dateTime (xs: dateTime ( "2005-01-10T12: 30-04: 10"))

Résultats: 01

fn: day-from-dateTime (datetime)

Renvoie la partie entière des valeurs de paramètres locaux de jour.

Exemples: jour de-dateTime (xs: dateTime ( "2005-01-10T12: 30-04: 10"))

Résultats: 10

fn: heures-de-dateTime (datetime)

Renvoie la partie entière des paramètres heures valeurs locales.

Exemples: heures-de-dateTime (xs: dateTime ( "2005-01-10T12: 30-04: 10"))

Résultats: 12

fn: minutes-de-dateTime (datetime)

Renvoie la partie entière des paramètres de la valeur locale de minute.

Exemples: minutes-de-dateTime (xs: dateTime ( "2005-01-10T12: 30-04: 10"))

Résultats: 30

fn: secondes-de-dateTime (datetime)

Renvoie la partie décimale des secondes valeurs de paramètres locaux.

Exemples: secondes-de-dateTime (xs: dateTime ( "2005-01-10T12: 30: 00-04: 10"))

Résultats: 0

fn: timezone-de-dateTime (datetime) Renvoie la partie de la région, si elle est présente.
fn: année de jour (date)

Dans les valeurs entières de retour qui représentent les paramètres locaux.

Exemples: année de jour (xs: Date ( "23/04/2005"))

Résultats: 2005

fn: mois de jour (date)

mois Entier Renvoie la valeur locale du paramètre indiqué.

Exemples: mois de jour (xs: Date ( "23/04/2005"))

Résultats: 4

fn: jour de jour (date)

Day retourne une valeur entière représente le paramètre local.

Exemples: jour de jour (xs: Date ( "23/04/2005"))

Résultats: 23

fn: timezone-de-jour (date) Renvoie la partie de la région, si elle est présente.
fn: heures-de-temps (temps)

Renvoie les heures de partie entière des valeurs de paramètres locaux représentés.

Exemples: heures-de-temps (xs: temps ( "10:22:00"))

Résultats: 10

fn: minutes-de-temps (temps)

Renvoie la partie entière des paramètres de la valeur locale de minute représente.

Exemples: minutes-de-temps (xs: temps ( "10:22:00"))

Résultats: 22

fn: secondes-de-temps (temps)

La partie entière de la seconde valeur de retour de paramètre indique le local.

Exemples: secondes-de-temps (xs: temps ( "10:22:00"))

Résultats: 0

fn: timezone-de-temps (temps) Renvoie la partie de la région, si elle est présente.
fn: ajuster-dateTime à fuseau horaire (datetime, fuseau horaire) Si l'argument de fuseau horaire est vide, il ne retourne pas le temps de dateTime zone. Sinon, elle retourne dateTime avec le fuseau horaire.
fn: ajuster jour à fuseau horaire (date, fuseau horaire) Si l'argument de fuseau horaire est vide, il ne retourne pas le temps de date zone. Sinon, elle renvoie la date avec le fuseau horaire.
fn: ajuster-time-to-fuseau horaire (heure, fuseau horaire) Si l'argument de fuseau horaire est vide, il ne retourne pas le fuseau horaire du temps. Sinon, le temps avec le fuseau horaire.

Et QNames fonctions liées

nom explication
fn: QName ()
fn: locale-name-de-QName ()
fn: namespace-uri-de-QName ()
fn: namespace-uri-for-prefix ()
fn: in-scope-préfixes ()
fn: resolve-QName ()

Une fonction du noeud

nom explication
  • fn: nom ()
  • fn: nom (nodeset)
Renvoie le nom du noeud courant ou spécifier le premier nœud du cluster.
  • fn: local-name ()
  • fn: local-name (nodeset)
Retourne le premier du nom du noeud courant ou spécifier un nœud du cluster - sans préfixe d'espace de noms.
  • fn: namespace-uri ()
  • fn: namespace-uri (nodeset)
Renvoie le ou les noeuds spécifiés dans le cluster namespace URI courant du premier noeud.
fn: lang (lang)

Si la langue du noeud courant correspond à la langue spécifiée, il retourne vrai.

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

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

  • fn: root ()
  • fn: root (noeud)
Renvoie le nœud racine de l'arbre ou du noeud courant noeud spécifié appartient. Habituellement, un nœud de document.

séquences Fonctions liées

fonction générale

nom explication
fn: indice de ((point, point, ...), searchitem)

Retour dans le projet égal aux paramètres searchitem de position de séquence.

Exemples: index de ((15, 40, 25, 40, 10), 40)

Résultats: (2, 4)

Exemples: indice de (( "a", "chien", "et", "a", "canard"), "a")

Résultat (1, 4)

Exemples: index de ((15, 40, 25, 40, 10), 18)

Résultats :()

fn: supprimer ((point, point, ...), position)

Elle retourne une nouvelle séquence de l'élément configuration des paramètres - supprimer le paramètre de position spécifie le projet.

Exemples: supprimer (( "ab", "cd", "ef"), 0)

"Ab", "cd" de résultats, "ef")

Exemples: supprimer (( "ab", "cd", "ef"), 1)

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

Exemples: supprimer (( "ab", "cd", "ef"), 4)

"Ab", "cd" de résultats, "ef")

fn: vide (point, point, ...)

Si la valeur du paramètre est une séquence vide, elle renvoie true, sinon retourne false.

Exemples: vide (supprimer (( "ab", "cd"), 1))

Résultats: faux

fn: existe (point, point, ...)

Si la valeur du paramètre est une séquence vide, elle renvoie true, sinon retourne false.

Exemples: existe (supprimer (( "ab"), 1))

Résultats: faux

fn: distinctes valeurs ((point, point, ...), la collation)

Le seul retour des valeurs différentes.

Exemples: Les valeurs distinctes ((1, 2, 3, 1, 2))

Résultats: (1, 2, 3)

fn: insérez-avant ((article, article, ...), pos, inserts)

Elle retourne une nouvelle séquence construite par le paramètre d'élément - paramètre spécifiant l'emplacement de l'insertion insère la valeur du paramètre pos.

Exemples: insérer-avant (( "ab", "cd"), 0, "gh")

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

Exemples: insérer-avant (( "ab", "cd"), 1, "gh")

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

Exemples: insérer-avant (( "ab", "cd"), 2, "gh")

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

Exemples: insérer-avant (( "ab", "cd"), 5, "gh")

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

fn: inverse ((point, point, ...))

Retours inverser l'ordre des éléments spécifiés.

Exemples: inverse (( "ab", "cd", "ef"))

"Ef", "cd" de résultats, "ab")

Exemples: inverse (( "ab"))

"Ab" de résultats)

fn: suite ((point, point, ...), commencer, len)

Renvoie le paramètre de démarrage spécifie l'emplacement du projet pour retourner la longueur séquence, séquence spécifiée par le paramètre len. Lieu du premier projet est de 1.

Exemples: suite ((item1 $, item2 $, item3 $, ...), 3)

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

Exemples: suite ((item1 $, item2 $, item3 $, ...), 2, 2)

Résultats: (item2 $, $ item3)

fn: unordered ((point, point, ...)) Selon l'ordre des décisions de mise en œuvre pour revenir au projet.

fonction de séquence de test des capacités

nom explication
fn: zéro ou-un (point, point, ...) Si un paramètre contient zéro ou un élément, puis retourner les paramètres, sinon une erreur est générée.
fn: un ou-plus (point, point, ...) Si un paramètre contient un ou plusieurs éléments, puis retourner les paramètres, sinon une erreur est générée.
fn: exactement-one (point, point, ...) Si un paramètre contient un élément, puis retourner les paramètres, sinon une erreur est générée.

Equals, Union, Intersection et Sauf

nom explication
fn: deep-égal (param1, param2, collation) Si param1 et param2 et égaux entre eux (deep-égalité), retourne vrai, sinon retourne false.

fonction d'agrégat

nom explication
fn: count ((point, point, ...)) Retourne le nombre de nœuds.
fn: avg ((arg, arg, ...)) Les valeurs moyennes des paramètres de retour. Exemples: avg ((1,2,3)) Résultat: 2
fn: max ((arg, arg, ...)) Retourne le paramètre est plus grande que les autres paramètres. Exemples: max ((1,2,3)) Résultats: Exemples 3: max (( 'a', 'k')) résultats: 'k'
fn: min ((arg, arg, ...)) En arrière plus petit que les autres paramètres des paramètres. Exemples: min ((1,2,3)) Résultats: Exemples 1: min Résultats (( 'a', 'k')): 'a'
fn: sum (arg, arg, ...) Renvoie le noeud spécifié définir la valeur de somme de chaque noeud.

la fonction de génération de séquence

nom explication
fn: id ((string, string, ...), noeud) Retourne une séquence de noeuds d'éléments qui ont une valeur d'ID égale à la valeur d'un ou plusieurs des valeurs spécifiées dans l'argument de chaîne
fn: idref ((string, string, ...), noeud) Retourne une séquence d'éléments ou d'attributs nœuds qui ont une valeur IDREF égale à la valeur d'un ou plusieurs des valeurs spécifiées dans l'argument de chaîne
fn: doc (URI)
fn: doc-disponibles (URI) Si la fonction doc () renvoie le nœud de document, il retourne vrai, sinon retourne false.
  • fn: collection ()
  • fn: collection (string)

fonctions de contexte

nom explication
fn: la position ()

Elle renvoie la position d'index du noeud en cours de traitement.

Exemples: // livre [Position () <= 3]

Résultats: Sélectionnez les trois premiers éléments du livre

fn: last ()

Elle renvoie le nombre d'éléments dans la liste des noeuds en cours de traitement.

Exemples: // livre [last ()]

Résultats: Sélectionnez le dernier élément d'un livre

fn: current-dateTime () Il renvoie la dateTime actuelle (avec le fuseau horaire).
fn: current-date () Renvoie la date actuelle (avec le fuseau horaire).
fn: current-time () Il retourne l'heure courante (avec le fuseau horaire).
fn: implicite-fuseau horaire () Valeur de retour de fuseau horaire implicite.
fn: default-collation () La commande revient à la valeur par défaut.
fn: static-base-uri () La valeur de retour de la base-uri.