Latest web development tutorials

XPath, XQuery e XSLT funzioni

Il seguente manuale di riferimento definisce le funzioni XPath 2.0, XQuery 1.0 e XSLT 2.0.


Funzione Manuale di riferimento

nota Il prefisso namespace funzione di default per fn:

nota namespace Funzione URI è: http://www.w3.org/2005/xpath-functions

funzione di accesso

nome spiegazione
fn: node-name (nodo) Restituisce il nodo parametro nome del nodo.
fn: nilled (nodo) Restituisce se rifiutare il valore booleano nodo argomento.
FN: dati (item.Item, ...) Accetta la sequenza di progetto e restituisce la sequenza di valori atomici.
  • fn: base-uri ()
  • fn: base-uri (nodo)
Restituisce il valore dell'attributo base-uri corrente specifica il nodo o nodi.
fn: documento-uri (nodo) Restituisce il valore della proprietà di documento-uri nodo specificato.

Errori e funzioni di tracking

nome spiegazione
  • fn: errore ()
  • fn: errore (errore)
  • fn: errore (errore, descrizione)
  • fn: errore (errore, descrizione, errore-oggetto)

Esempi: errore (fn: QName ( 'http://example.com/test', 'err: toohigh'), 'Errore: il prezzo è troppo alto')

Risultati: Restituisce http://example.com/test#toohigh~~number=plural e stringa per l'ambiente di elaborazione esterna "Errore: prezzo è troppo alto".

fn: trace (valore, etichetta) E 'usato per interrogare il debug.

valori funzioni relative

nome spiegazione
fn: il numero (arg)

Restituisce il valore del parametro. Il parametro è un valore, una stringa o set di nodi booleana.

Esempi: il numero ( '100')

Risultati: 100

fn: abs (num)

Restituisce il valore assoluto del parametro.

Esempi: abs (3.14)

Risultati: 3.14

Esempi: abs (-3.14)

Risultati: 3.14

fn: soffitto (num)

Restituisce il più piccolo numero intero maggiore di parametro num.

Esempi: soffitto (3.14)

Risultati: 4

fn: floor (num)

Restituisce il più grande intero non maggiore di parametro num.

Esempi: piano (3.14)

Risultati: 3

fn: round (num)

L'argomento num arrotondato al numero intero più vicino.

Esempi: tondo (3.14)

Risultati: 3

fn: round-half-to-even ()

Esempi: round-half-to-even (0,5)

Risultati: 0

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

Risultati: 2

Esempi: round-half-to-even (2,5)

Risultati: 2

Funzioni sulle stringhe

nome spiegazione
fn: string (arg)

Restituisce il valore stringa del parametro. Gli argomenti possono essere numeri, valori logici, o un insieme di nodi.

Esempi: string (314)

Risultato: il "314"

FN: codepoints-to-string (int, int, ...)

Secondo la sequenza di punto di codice restituisce una stringa.

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

Risultati: 'Teresa'

fn: string-to-codepoints (stringa)

Secondo ritorno stringa di sequenza di punti di codice.

Esempi: string-to-codepoints ( "Teresa")

Risultato: 84, 104, 233, 114, 232, 115, 101

fn: codepoint-uguale (comp1, comp2) Secondo il confronto punto di codice Unicode, se il valore è uguale al valore di comp2 comp1 Restituisce vero. (Http://www.w3.org/2005/02/xpath-functions/collation/codepoint), altrimenti restituisce False.
  • fn: compare (comp1, comp2)
  • fn: compare (comp1, comp2, collazione)

Se comp1 meno di comp2, viene restituito -1. Se comp1 pari comp2, viene restituito 0. Se comp1 maggiore di comp2, 1 viene restituito. (Secondo le regole utilizzate dal controllo).

Esempio: confronta ( 'ghi', 'ghi')

Risultati: 0

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

Restituisce la concatenazione di stringhe.

Esempi: concat ( 'XPath', 'è', 'FUN!')

Risultati: 'XPath è divertente!'

fn: string-join ((string, string, ...), settembre)

Utilizzare sep come delimitatore l'argomento per restituire la stringa di parametri stringa dopo la cucitura.

Esempi: string-join ( '! Fun' ( 'Noi', 'sono', 'avere',), '')

Risultati: 'Ci si divertono!'

Esempi: string-join ( '! Fun' ( 'Noi', 'sono', 'avere',))

Risultati: 'Wearehavingfun!'

Esempi: string-join ((), 'settembre')

Risultati: ''

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

Restituisce la sottostringa dalla posizione di partenza dell'inizio della lunghezza specificata. Indice del primo carattere è 1. Se si omette l'argomento len dalla posizione di partenza al fine di una stringa viene restituito.

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

Risultati: 'Beat'

Esempi: substring ( 'Beatles', 2)

Risultati: '' eatles

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

Restituisce la lunghezza della stringa. Se non c'è argomento stringa, viene restituita la lunghezza del valore di stringa del nodo corrente.

Esempi: stringa di lunghezza ( "Beatles)

Risultati: 7

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

Rimuovere l'inizio e la fine della stringa specificata blank, e tutti sostituiti da una serie di interna e restituisce il risultato. Se non c'è argomento stringa, il processo del nodo corrente.

Esempi: normalize-spazio ( 'The XML')

Risultati: 'The XML'

fn: normalize-unicode () Attuazione della normalizzazione Unicode.
fn: upper-case (stringa)

L'argomento stringa in lettere maiuscole.

Esempi: maiuscole ( 'The XML')

Risultati: 'L'XML'

fn: minuscola (stringa)

L'argomento stringa convertita in minuscolo.

Esempi: minuscole ( 'The XML')

Risultati: 'xml'

fn: translate (string1, string2, string3)

Il stringa1 a stringa2 sostituito string3.

Esempi: traducono ('12: 30 ',' 30 ',' 45 ')

Risultati: '12: 45 '

Esempi: traducono ('12: 30 ',' 03 ',' 54 ')

Risultati: '12: 45 '

Esempi: traducono ('12: 30 ',' 0123 ',' ABCD ')

Risultati: "BC: da '

fn: fuga-uri (stringURI, ESC-res)

Esempi: fuga-uri ( "http://example.com/test#car", vero ())

Risultati: "http% 3A% 2F% 2Fexample.com% 2Ftest # auto"

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

Risultati: "http://example.com/test#car"

Esempi: fuga-uri ( "http://example.com/~bebe", false ())

Risultati: "http://example.com/~b%C3%A9b%C3%A9"

fn: contiene (string1, string2)

Se stringa1 contiene stringa2, restituisce vero, altrimenti restituisce false.

Esempi: contiene ( 'XML', 'XM')

Risultati: true

FN: inizia-con (string1, string2)

Se stringa1 inizia con stringa2, restituisce vero, altrimenti restituisce false.

Esempi: inizia-con ( 'XML', 'X')

Risultati: true

fn: finisce-con (string1, string2)

Se stringa1 con stringa2 fine restituisce true, altrimenti restituisce false.

Esempi: le estremità-con ( 'XML', 'X')

Risultati: falso

fn: substring-before (string1, string2)

Restituisce una sottostringa di stringa1 stringa2 comparire davanti.

Esempi: substring-prima ('12 / 10 ',' / ')

Risultati: '12 '

fn: substring-after (string1, string2)

Restituisce una sottostringa di stringa1 stringa2 appare più avanti.

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

Risultati: '10 '

FN: partite (string, pattern)

Se stringa corrisponde al modello specificato, restituisce vero, altrimenti restituisce false.

Esempi: partite ( "Merano", "corse")

Risultati: true

fn: replace (string, pattern, sostituire)

Il modo specificato è sostituito sostituire parametro e restituisce il risultato.

Esempi: sostituire ( "Bella Italia", "l", "*")

Risultati: 'Be ** una Ita * ia'

Esempi: sostituire ( "Bella Italia", "l", "")

Risultati: 'Bea Itaia'

fn: tokenize (string, pattern)

Esempi: tokenize ( "XPath è divertente", "\ s +")

Risultati :( "XPath", "è", "divertimento")

Funzione anyURI per

nome spiegazione
fn: determinazione-uri (relativo, base)

Funzioni di valori booleani

nome spiegazione
fn: boolean (arg) Restituisce un valore numerico, stringa o set di nodi booleana.
fn: non (arg)

In primo luogo, boolean () per ripristinare i parametri di un valore booleano. Se il valore booleano è falso, restituisce vero, altrimenti restituisce vero.

Esempio: non (true ())

Risultati: falso

fn: true ()

Restituisce un valore booleano true.

Esempi: true ()

Risultati: true

fn: false ()

Restituisce un valore booleano falso.

Esempi: false ()

Risultati: falso

Funzioni relative alla durata, la data e l'ora

Data, ora, durata della funzione di componenti di estrazione

nome spiegazione
fn: dateTime (data, ora) Gli argomenti di data e ora.
FN: anni-da-durata (datetimedur) La parte intera del Anno del valore di ritorno di una notazione standard per rappresentare parole.
FN: mesi-da-durata (datetimedur) Restituisce la parte intera di valori dei parametri del mese, una notazione standard per rappresentare parole.
FN: giorni-da-durata (datetimedur) Restituisce la parte intera dei valori dei parametri del giorno, una notazione standard per rappresentare parole.
FN: ore-da-durata (datetimedur) Restituisce la parte intera di valori dei parametri del momento, la notazione standard per rappresentare parole.
FN: minuti-da-durata (datetimedur) Restituisce la parte intera del verbale dei valori dei parametri, la notazione standard per rappresentare parole.
FN: secondi-da-durata (datetimedur) Restituisce la parte decimale del numero di minuti di valori dei parametri, una notazione standard per rappresentare parole.
fn: anno-da-dateTime (datetime)

Restituisce i valori dei parametri intero nella sezione locale.

Esempi: anno-da-dateTime (xs: dateTime ( "2005-01-10T12: 30-04: 10"))

Risultati: 2005

fn: mese-da-dateTime (datetime)

Restituisce la parte intera di valori mensili dei parametri locali.

Esempi: mese-da-dateTime (xs: dateTime ( "2005-01-10T12: 30-04: 10"))

Risultati: 01

fn: giorno-da-dateTime (datetime)

Restituisce la parte intera di valori dei parametri locali giorno.

Esempi: giorno-da-dateTime (xs: dateTime ( "2005-01-10T12: 30-04: 10"))

Risultati: 10

FN: ore-da-dateTime (datetime)

Restituisce la parte intera del parametro Ore valori locali.

Esempi: ore-da-dateTime (xs: dateTime ( "2005-01-10T12: 30-04: 10"))

Risultati: 12

FN: minuti-da-dateTime (datetime)

Restituisce la parte intera di parametri del valore locale minuto.

Esempi: minuti-da-dateTime (xs: dateTime ( "2005-01-10T12: 30-04: 10"))

Risultati: 30

FN: secondi-da-dateTime (datetime)

Restituisce la parte decimale del secondo valori dei parametri locali.

Esempi: secondi-da-dateTime (xs: dateTime ( "2005-01-10T12: 30: 00-04: 10"))

Risultati: 0

fn: fuso orario-da-dateTime (datetime) Restituisce la porzione di regione, se presente.
fn: anno-da-date (data)

In valori interi di ritorno che rappresentano i parametri locali.

Esempi: anno-da-date (xs: data ( "2005-04-23"))

Risultati: 2005

fn: mese-da-date (data)

mese Intero Restituisce il valore locale del parametro indicato.

Esempi: mese-da-data (xs: data ( "2005-04-23"))

Risultati: 4

fn: giorno-da-date (data)

Giorno restituire un valore intero rappresenta il parametro locale.

Esempi: giorno-da-date (xs: data ( "2005-04-23"))

Risultati: 23

fn: fuso orario-da-date (data) Restituisce la porzione di regione, se presente.
FN: ore-di-tempo (tempo)

Restituisce le ore parte intera i valori dei parametri locali rappresentate.

Esempi: ore-di-tempo (xs: tempo ( "10:22:00"))

Risultati: 10

FN: minuti-da-tempo (tempo)

Restituisce la parte intera di parametri del valore locale minuti rappresenta.

Esempi: minuti-da-tempo (xs: tempo ( "10:22:00"))

Risultati: 22

FN: secondi-da-tempo (tempo)

La parte intera del secondo valore di parametro di ritorno indica il locale.

Esempi: secondi-da-tempo (xs: tempo ( "10:22:00"))

Risultati: 0

fn: fuso orario-da-time (tempo) Restituisce la porzione di regione, se presente.
fn: regolare-dateTime-to-fuso orario (datetime, fuso orario) Se l'argomento fuso orario è vuota, restituisce il tempo dateTime orario. In caso contrario, restituisce dateTime con fuso orario.
fn: regolare-Data-to-fuso orario (data, fuso orario) Se l'argomento fuso orario è vuota, restituisce nessun momento la data orario. In caso contrario, restituisce la data con il fuso orario.
fn: regolare-time-to-fuso orario (ora, fuso orario) Se l'argomento fuso orario è vuota, restituisce il tempo del fuso orario. In caso contrario, il tempo con il fuso orario.

E QNames funzioni relative

nome spiegazione
fn: QName ()
fn: local-name-from-QName ()
fn: namespace-uri-from-QName ()
fn: namespace-uri-per-prefix ()
fn: in-scope-prefissi ()
fn: resolve-QName ()

Una funzione del nodo

nome spiegazione
  • fn: nome ()
  • fn: nome (serie di nodi)
Restituisce il nome del nodo corrente o specificare il primo nodo del cluster.
  • fn: local-name ()
  • fn: local-name (serie di nodi)
Restituisce il primo del nome del nodo corrente o specificare un nodo nel cluster - senza prefisso di namespace.
  • fn: namespace-uri ()
  • fn: namespace-uri (serie di nodi)
Ritorna il nodo o nodi specificato nel cluster corrente namespace URI del primo nodo.
fn: lang (lang)

Se la lingua del nodo corrente corrisponde alla lingua specificata, restituisce vero.

Esempi: Lang ( "en") vale per <p xml: lang = "it"> ... </ p>

Esempi: Lang ( "de") è falsa per <p xml: lang = "it"> ... </ p>

  • fn: root ()
  • fn: root (nodo)
Restituisce il nodo radice dell'albero o il nodo corrente nodo specificato appartiene. Di solito un nodo di documento.

sequenze di funzioni relative

funzione generale

nome spiegazione
fn: index-of ((voce, articolo, ...), searchitem)

Indietro nel progetto uguali ai parametri searchitem posizione sequenza.

Esempi: index-di ((15, 40, 25, 40, 10), 40)

Risultati: (2, 4)

Esempi: index-di (( "a", "cane", "e", "a", "anatra"), "a")

Risultato (1, 4)

Esempi: index-di ((15, 40, 25, 40, 10), 18)

Risultati :()

fn: remove ((voce, articolo, ...), posizione)

Esso restituisce una nuova sequenza di configurazione dei parametri voce - cancellare parametro di posizione specifica del progetto.

Esempi: rimuovere (( "ab", "cd", "EF"), 0)

Risultati :( "ab", "cd", "EF")

Esempi: rimuovere (( "ab", "cd", "EF"), 1)

Risultati :( "cd", "EF")

Esempi: rimuovere (( "ab", "cd", "EF"), 4)

Risultati :( "ab", "cd", "EF")

fn: empty (voce, articolo, ...)

Se il valore del parametro è una sequenza vuota, restituisce vero, altrimenti restituisce false.

Esempi: vuota (rimuovere (( "ab", "cd"), 1))

Risultati: falso

fn: esiste (voce, articolo, ...)

Se il valore del parametro non è una sequenza vuota, restituisce vero, altrimenti restituisce false.

Esempi: esiste (rimuovi (( "ab"), 1))

Risultati: falso

FN: distinct-values ​​((voce, articolo, ...), le regole di confronto)

L'unica restituire valori diversi.

Esempi: valori distinti ((1, 2, 3, 1, 2))

Risultati: (1, 2, 3)

fn: insert-before ((voce, articolo, ...), pos, inserti)

Esso restituisce una nuova sequenza costruita dal parametro item - parametro che specifica la posizione di inserimento inserisce il valore del parametro pos.

Esempi: insert-prima (( "ab", "cd"), 0, "gh")

Risultati :( "gh", "ab", "cd")

Esempi: insert-prima (( "ab", "cd"), 1, "gh")

Risultati :( "gh", "ab", "cd")

Esempi: insert-prima (( "ab", "cd"), 2, "gh")

Risultati :( "ab", "gh", "cd")

Esempi: insert-prima (( "ab", "cd"), 5, "gh")

Risultati :( "ab", "cd", "gh")

fn: inverso ((voce, articolo, ...))

Restituisce invertire l'ordine degli elementi specificati.

Esempi: reverse (( "ab", "cd", "EF"))

Risultati :( "EF", "cd", "ab")

Esempi: inversa (( "ab"))

Risultati :( "ab")

fn: subsequence ((voce, articolo, ...), avviare, len)

Restituisce il parametro di avvio specifica l'ubicazione del progetto per riportare la lunghezza della sequenza, sequenza specificata dal parametro len. Location del primo progetto è 1.

Esempi: subsequence (($ elemento1, $ item2, $ item3, ...), 3)

Risultati: ($ item3, ...)

Esempi: subsequence (($ elemento1, $ item2, $ item3, ...), 2, 2)

Risultati: ($ item2, $ Item3)

fn: non ordinata ((voce, articolo, ...)) Secondo l'ordine di decisioni di attuazione per tornare al progetto.

funzione di sequenza di test Capacità

nome spiegazione
fn: zero-or-one (voce, articolo, ...) Se un parametro contiene zero o un articolo, per poi tornare parametri, altrimenti viene generato un errore.
fn: one-o-più (voce, articolo, ...) Se un parametro contiene uno o più elementi, per poi tornare parametri, in caso contrario viene generato un errore.
fn: exactly-one (voce, articolo, ...) Se un parametro contiene un elemento, per poi tornare parametri, altrimenti viene generato un errore.

Uguale, unione, intersezione e Salvo

nome spiegazione
fn: deep-equal (param1, param2, collazione) Se param1 e param2 e uguali tra loro (deep-equal), restituisce vero, altrimenti restituisce false.

funzione di aggregazione

nome spiegazione
fn: count ((voce, articolo, ...)) Restituisce il numero di nodi.
fn: avg ((arg, arg, ...)) I valori medi dei parametri di ritorno. Esempi: avg ((1,2,3)) Risultato: 2
fn: max ((arg, arg, ...)) Restituisce il parametro è maggiore rispetto agli altri parametri. Esempi: max ((1,2,3)) Risultati: Esempi 3: max (( 'a', 'k')) Risultati: 'k'
fn: min ((arg, arg, ...)) Indietro piccolo di altri parametri dei parametri. Esempi: min ((1,2,3)) Risultati: Esempi 1: min (( 'A', 'k')) Risultati: 'a'
fn: sum (arg, arg, ...) Restituisce il nodo specificato impostare il valore somma di ogni nodo.

funzione di generazione di Sequence

nome spiegazione
fn: id ((string, string, ...), il nodo) Restituisce una sequenza di nodi di elementi che hanno un valore ID pari al valore di uno o più valori specificati nell'argomento stringa
fn: IDREF ((string, string, ...), il nodo) Restituisce una sequenza di elemento o attributo nodi che hanno un valore di IDREF pari al valore di uno o più dei valori specificati nell'argomento di stringa
fn: doc (URI)
fn: doc-disponibili (URI) Se la funzione doc () restituisce il nodo del documento, restituisce vero, altrimenti restituisce false.
  • fn: collezione ()
  • fn: collezione (stringa)

funzioni contestuali

nome spiegazione
fn: position ()

Esso restituisce la posizione di indice del nodo in fase di elaborazione.

Esempi: // libro [position () <= 3]

Risultati: Selezionare i primi tre elementi del libro

fn: last ()

Restituisce il numero di elementi nella lista dei nodi in fase di elaborazione.

Esempi: // libro [last ()]

Risultati: Selezionare l'ultimo elemento di un libro

fn: current-dateTime () Esso restituisce la dateTime corrente (con fuso orario).
fn: current-date () Restituisce la data corrente (con fuso orario).
fn: current-time () Esso restituisce l'ora corrente (con fuso orario).
fn: implicit-timezone () Valore di ritorno fuso orario implicito.
fn: default-collation () Il controllo ritorna al valore di default.
fn: static-base-uri () Il valore di ritorno della base-uri.