XPath, XQuery og XSLT Funktioner
- Forrige Side XPath Opsummering
- Næste Side XPath Læringsressourcer
adgangsfunktioner
Navn | Beskrivelse |
---|---|
fn:node-name(node) | returnerer nodens navn for parameter noden. |
fn:nilled(node) | returnerer et boolean værdi der angiver om parameter noden afvises. |
fn:data(item.item,...) | accepterer en sekvens af elementer og returnerer en sekvens af atomværdier. |
|
returnerer værdien af base-uri egenskaben for den aktuelle node eller den specificerede node. |
fn:document-uri(node) | returnerer værdien af document-uri egenskaben for den specificerede node. |
fejl- og sporingfunktioner
Navn | Beskrivelse |
---|---|
|
eksempel:error(fn:QName('http://example.com/test', 'err:toohigh'), 'Error: Price is too high') resultat: Returnerer http://example.com/test#toohigh og strengen "Error: Price is too high" til den eksterne behandle miljø. |
fn:trace(value,label) | bruges til at debug forespørgsler. |
funktioner relateret til numeriske værdier
Navn | Beskrivelse |
---|---|
fn:number(arg) |
returnerer parameterets numeriske værdi. Parameter kan være boolean værdi, streng eller node sæt. eksempel:number('100') resultat: 100 |
fn:abs(num) |
returnerer parameterets absolute værdi. eksempel:abs(3.14) resultat: 3.14 eksempel:abs(-3.14) resultat: 3.14 |
fn:ceiling(num) |
returnerer det mindste heltal større end num parameteret. eksempel:ceiling(3.14) Resultat: 4 |
fn:floor(num) |
Returnerer det største heltal, der er mindre end eller lig med num parameteren. Eksempel: floor(3.14) Resultat: 3 |
fn:round(num) |
Runder num parameteren op til det nærmeste heltal. Eksempel: round(3.14) Resultat: 3 |
fn:round-half-to-even() |
Eksempel: round-half-to-even(0.5) Resultat: 0 Eksempel: round-half-to-even(1.5) Resultat: 2 Eksempel: round-half-to-even(2.5) Resultat: 2 |
Funktioner til strenge
Navn | Beskrivelse |
---|---|
fn:string(arg) |
Returnerer den strenske værdi af argumentet. Argumentet kan være et tal, en logisk værdi eller en nodesæt. Eksempel: string(314) Resultat: "314" |
fn:codepoints-to-string(int,int,...) |
Returnerer en streng baseret på sekvensen af kodepunkter. Eksempel: codepoints-to-string(84, 104, 233, 114, 232, 115, 101) Resultat: 'Thérèse' |
fn:string-to-codepoints(string) |
Returnerer en sekvens af kodepunkter baseret på streng. Eksempel: string-to-codepoints("Thérèse") Resultat: 84, 104, 233, 114, 232, 115, 101 |
fn:codepoint-equal(comp1,comp2) | Baseret på Unicode-kodepunkts-sammenligning, returneres true, hvis værdien af comp1 er lig med værdien af comp2. (http://www.w3.org/2005/02/xpath-functions/collation/codepoint), ellers returneres false. |
|
Hvis comp1 er mindre end comp2, returneres -1. Hvis comp1 er lig med comp2, returneres 0. Hvis comp1 er større end comp2, returneres 1. (afhængigt af den anvendte sammenligningsregel). Eksempel: compare('ghi', 'ghi') Resultat: 0 |
fn:concat(string,string,...) |
Returnerer en sammenføjning af strenge. Eksempel: concat('XPath ','er ','sjov!') Resultat: 'XPath er sjov!' |
fn:join((string,string,...),sep) |
Brug sep-parametret som adskiller for at returnere en sammenkædet streng af string-argumentet. Eksempel: string-join(('We', 'are', 'having', 'fun!'), ' ') Resultat: ' We are having fun! ' Eksempel: string-join(('We', 'are', 'having', 'fun!')) Resultat: 'Wearehavingfun!' Eksempel: string-join((), 'sep') Resultat: '' |
|
Returnerer en substring af den angivne længde fra start-positionen. Den første karakter har indeks 1. Hvis len-parametret udelades, returneres en substring fra position start til slutningen af strengen. Eksempel: substring('Beatles',1,4) Resultat: 'Beat' Eksempel: substring('Beatles',2) Resultat: 'eatles' |
|
Returnerer længden af den angivne streng. Hvis der ikke er angivet string-argument, returneres længden af den aktuelle nodes strengværdi. Eksempel: string-length('Beatles') Resultat: 7 |
|
Fjerner angivne strengens start- og slutblanks, og erstatter alle mellemrumsserier inden for med et mellemrum, og returnerer derefter resultatet. Hvis der ikke er angivet string-argument, behandles den aktuelle node. Eksempel: normalize-space(' The XML ') Resultat: 'The XML' |
fn:normalize-unicode() | Udfører Unicode-standarisering. |
fn:upper-case(string) |
Konverterer string-argumentet til store bogstaver. Eksempel: upper-case('The XML') Resultat: 'THE XML' |
fn:lower-case(string) |
Konverterer string-argumentet til små bogstaver. Eksempel: lower-case('The XML') Resultat: 'the xml' |
fn:translate(string1,string2,string3) |
Erstat string2 med string3 i string1. Eksempel: translate('12:30','30','45') Resultat: '12:45' Eksempel: translate('12:30','03','54') Resultat: '12:45' Eksempel: translate('12:30','0123','abcd') Resultat: 'bc:da' |
fn:escape-uri(stringURI,esc-res) |
Eksempel: escape-uri("http://example.com/test#car", true()) Resultat: "http%3A%2F%2Fexample.com%2Ftest#car" Eksempel: escape-uri("http://example.com/test#car", false()) Resultat: "http://example.com/test#car" Eksempel: escape-uri ("http://example.com/~bébé", false()) Resultat: "http://example.com/~b%C3%A9b%C3%A9" |
fn:contains(string1,string2) |
Returner true, hvis string1 indeholder string2, ellers returner false. Eksempel: contains('XML','XM') Resultat: true |
fn:starts-with(string1,string2) |
Returner true, hvis string1 starter med string2, ellers returner false. Eksempel: starts-with('XML','X') Resultat: true |
fn:ends-with(string1,string2) |
Returner true, hvis string1 slutter med string2, ellers returner false. Eksempel: ends-with('XML','X') Resultat: false |
fn:substring-before(string1,string2) |
Returner den understreng, der kommer før string2 i string1. Eksempel: substring-before('12/10','/') Resultat: '12' |
fn:substring-after(string1,string2) |
Returner den understreng, der følger string2 i string1. Eksempel: substring-after('12/10','/') Resultat: '10' |
fn:matches(string,pattern) |
Returnerer true, hvis string parameter matcher den angivne mønster, ellers returneres false. Eksempel: matches("Merano", "ran") Resultat: true |
fn:replace(string,pattern,replace) |
Erstatter den angivne mønster med replace parameter og returnerer resultatet. Eksempel: replace("Bella Italia", "l", "*") Resultat: 'Be**a Ita*ia' Eksempel: replace("Bella Italia", "l", "") Resultat: 'Bea Itaia' |
fn:tokenize(string,pattern) |
Eksempel: tokenize("XPath is fun", "\s+") Resultat: ("XPath", "is", "fun") |
Funktioner relateret til anyURI
Navn | Beskrivelse |
---|---|
fn:resolve-uri(relative,base) |
Funktioner relateret til booleske værdier
Navn | Beskrivelse |
---|---|
fn:boolean(arg) | Returnerer boolesk værdi for et tal, en streng eller en nodesæt. |
fn:not(arg) |
Først gendannes parameteren til en boolesk værdi ved hjælp af boolean() funktionen. Hvis den booleske værdi er false, returneres true, ellers returneres true. Eksempel: not(true()) Resultat: false |
fn:true() |
Returnerer boolesk værdi true. Eksempel: true() Resultat: true |
fn:false() |
Returnerer boolesk værdi false. Eksempel: false() Resultat: false |
Funktioner relateret til varighed, dato og tid
Funktioner til at extrahere komponenter af dato, tid og varighed
Navn | Beskrivelse |
---|---|
fn:dateTime(date,time) | Konverterer parameter til dato og tid. |
fn:years-from-duration(datetimedur) | Returnerer parameterværdiens årgangsdel som et heltal, præsenteret i standardvokabular. |
fn:months-from-duration(datetimedur) | Returnerer parameterværdiens månedsdel som et heltal, præsenteret i standardvokabular. |
fn:days-from-duration(datetimedur) | Returnerer parameterværdiens deldel som et heltal, præsenteret i standardvokabular. |
fn:hours-from-duration(datetimedur) | Returnerer værdens timer som et heltal, præsenteret i standardvokabular. |
fn:minutes-from-duration(datetimedur) | Returnerer værdens minutter som et heltal, præsenteret i standardvokabular. |
fn:seconds-from-duration(datetimedur) | Returnerer værdens minutter som et decimaltal, præsenteret i standardvokabular. |
fn:year-from-dateTime(datetime) |
Returnerer det lokale værdi af parameteren som et heltal, der repræsenterer året. Eksempel: year-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10")) Resultat: 2005 |
fn:month-from-dateTime(datetime) |
Returnerer det lokale værdi af parameteren som et heltal, der repræsenterer måneden. Eksempel: month-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10")) Resultat: 01 |
fn:day-from-dateTime(datetime) |
Returnerer det lokale værdi af parameteren som et heltal, der repræsenterer dagen. Eksempel: day-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10")) Resultat: 10 |
fn:hours-from-dateTime(datetime) |
Returnerer det lokale værdi af parameteren som et heltal, der repræsenterer timene. Eksempel: hours-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10")) Resultat: 12 |
fn:minutes-from-dateTime(datetime) |
Returnerer det lokale værdi af parameteren som et heltal, der repræsenterer minutterne. Eksempel: minutes-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10")) Resultat: 30 |
fn:seconds-from-dateTime(datetime) |
Returnerer det lokale værdi af parameteren som et decimaltal, der repræsenterer sekunderne. Eksempel: seconds-from-dateTime(xs:dateTime("2005-01-10T12:30:00-04:10")) Resultat: 0 |
fn:timezone-from-dateTime(datetime) | Returnerer parameterens tidszonestørrelse, hvis den findes. |
fn:year-from-date(date) |
Returnerer det lokale værdi af parameteren som et heltal, der repræsenterer året. Eksempel: year-from-date(xs:date("2005-04-23")) Resultat: 2005 |
fn:month-from-date(date) |
Returnerer det hele månedsværdi i det lokale værdi af parameteren. Eksempel: month-from-date(xs:date("2005-04-23")) Resultat: 4 |
fn:day-from-date(date) |
Returnerer det hele dags værdi i det lokale værdi af parameteren. Eksempel: day-from-date(xs:date("2005-04-23")) Resultat: 23 |
fn:timezone-from-date(date) | Returnerer parameterens tidszonestørrelse, hvis den findes. |
fn:hours-from-time(time) |
Returnerer det hele times værdi i det lokale værdi af parameteren. Eksempel: hours-from-time(xs:time("10:22:00")) Resultat: 10 |
fn:minutes-from-time(time) |
Returnerer det hele minutters værdi i det lokale værdi af parameteren. Eksempel: minutes-from-time(xs:time("10:22:00")) Resultat: 22 |
fn:seconds-from-time(time) |
Returnerer det hele sekunders værdi i det lokale værdi af parameteren. Eksempel: seconds-from-time(xs:time("10:22:00")) Resultat: 0 |
fn:timezone-from-time(time) | Returnerer parameterens tidszonestørrelse, hvis den findes. |
fn:adjust-dateTime-to-timezone(datetime,timezone) | Hvis timezone-argumentet er tomt, returneres dateTime uden tidszone. Ellers returneres dateTime med tidszone. |
fn:adjust-date-to-timezone(date,timezone) | Hvis timezone-argumentet er tomt, returneres date uden tidszone. Ellers returneres date med tidszone. |
fn:adjust-time-to-timezone(time,timezone) | Hvis timezone-argumentet er tomt, returneres time uden tidszone. Ellers returneres time med tidszone. |
Funktioner relateret til QNames
Navn | Beskrivelse |
---|---|
fn:QName() | |
fn:local-name-from-QName() | |
fn:namespace-uri-from-QName() | |
fn:namespace-uri-for-prefix() | |
fn:in-scope-prefixes() | |
fn:resolve-QName() |
Funktioner relateret til noder
Navn | Beskrivelse |
---|---|
|
Returnerer navnet på den aktuelle node eller den første node i den specificerede nodegruppe. |
|
Returnerer navnet på den aktuelle node eller den første node i den specificerede nodegruppe - uden navnerumpræfiks. |
|
Returnerer navnerum URI'en for den aktuelle node eller den første node i den specificerede nodegruppe. |
fn:lang(lang) |
Returnerer true, hvis sprog for den aktuelle node matcher det specificerede sprog. Eksempel: Lang("en") er true for <p xml:lang="en">...</p> Eksempel: Lang("de") er false for <p xml:lang="en">...</p> |
|
Returnerer rodnoden for den node-træ, som den aktuelle node eller den specificerede node tilhører. Det er normalt et dokumentnode. |
Funktioner relateret til sekvenser
Generelle funktioner
Navn | Beskrivelse |
---|---|
fn:index-of((item,item,...),searchitem) |
Returnerer positionen af elementet i elementsekvensen, der er lig med searchitem parameteren. Eksempel: index-of ((15, 40, 25, 40, 10), 40) Resultat: (2, 4) Eksempel: index-of (("a", "dog", "and", "a", "duck"), "a") Resultat (1, 4) Eksempel: index-of ((15, 40, 25, 40, 10), 18) Resultat: () |
fn:remove((item,item,...),position) |
Returnerer en ny sekvens konstrueret af item parameter - samtidig sletter den position parameter specificerede element. Eksempel: remove(("ab", "cd", "ef"), 0) Resultat: ("ab", "cd", "ef") Eksempel: remove(("ab", "cd", "ef"), 1) Resultat: ("cd", "ef") Eksempel: remove(("ab", "cd", "ef"), 4) Resultat: ("ab", "cd", "ef") |
fn:empty(item,item,...) |
Hvis parameterværdien er en tom sekvens, returneres true, ellers returneres false. Eksempel: empty(remove(("ab", "cd"), 1)) Resultat: false |
fn:exists(item,item,...) |
Returnerer true hvis parameterverdien ikke er en tom sekvens, ellers returnerer false. Eksempel: exists(remove(("ab"), 1)) Resultat: false |
fn:distinct-values((item,item,...),collation) |
Returnerer unike verdier. Eksempel: distinct-values((1, 2, 3, 1, 2)) Resultat: (1, 2, 3) |
fn:insert-before((item,item,...),pos,inserts) |
Returnerer en ny sekvens konstruert av item parameteren - samtidig med å sette inserts parameterens verdi på pos parameteren angitt posisjon. Eksempel: insert-before(("ab", "cd"), 0, "gh") Resultat: ("gh", "ab", "cd") Eksempel: insert-before(("ab", "cd"), 1, "gh") Resultat: ("gh", "ab", "cd") Eksempel: insert-before(("ab", "cd"), 2, "gh") Resultat: ("ab", "gh", "cd") Eksempel: insert-before(("ab", "cd"), 5, "gh") Resultat: ("ab", "cd", "gh") |
fn:reverse((item,item,...)) |
Returnerer omvendt rekkefølge av de angitte elementene. Eksempel: reverse(("ab", "cd", "ef")) Resultat: ("ef", "cd", "ab") Eksempel: reverse(("ab")) Resultat: ("ab") |
fn:subsequence((item,item,...),start,len) |
Returnerer en sekvens av elementer fra start parameteren angitt posisjon, lengden på sekvensen bestemmes av len parameteren. Posisjonen til det første elementet er 1. Eksempel: subsequence(($item1, $item2, $item3,...), 3) Resultat: ($item3, ...) Eksempel: subsequence(($item1, $item2, $item3, ...), 2, 2) Resultat: ($item2, $item3) |
fn:unordered((item,item,...)) | Returnerer projekter i henhold til den bestemte rekkefølgen. |
Test funktion for sekvenskapacitet
Navn | Beskrivelse |
---|---|
fn:zero-or-one(item,item,...) | Returnerer argumentet, hvis det indeholder ingen eller en element, ellers genererer den en fejl |
fn:one-or-more(item,item,...) | Returnerer argumentet, hvis det indeholder en eller flere elementer, ellers genererer den en fejl |
fn:exactly-one(item,item,...) | Returnerer argumentet, hvis det indeholder en element, ellers genererer den en fejl |
Lige, Union, Intersection og Except
Navn | Beskrivelse |
---|---|
fn:deep-equal(param1,param2,collation) | Returnerer true, hvis param1 og param2 er ens (deep-equal), ellers returnerer false |
Samlefunktion
Navn | Beskrivelse |
---|---|
fn:count((item,item,...)) | Returnerer antallet af noder |
fn:avg((arg,arg,...)) |
Returnerer gennemsnittet af værdierne for argumenterne Eksempel: avg((1,2,3)) Resultat: 2 |
fn:max((arg,arg,...)) |
Returnerer argumentet, der er større end de andre parametre Eksempel: max((1,2,3)) Resultat: 3 Eksempel: max(('a', 'k')) Resultat: 'k' |
fn:min((arg,arg,...)) |
Returnerer argumentet, der er mindre end de andre parametre Eksempel: min((1,2,3)) Resultat: 1 Eksempel: min(('a', 'k')) Resultat: 'a' |
fn:sum(arg,arg,...) | Returnerer summen af værdierne for hver node i den specificerede nodekreds |
Funktion til at generere sekvens
Navn | Beskrivelse |
---|---|
fn:id((streng,streng,...),node) | Returnerer en sekvens af elementnoder, der har en ID-værdi, der er lig værdien af en eller flere af de værdier specificeret i strengargumentet |
fn:idref((streng,streng,...),node) | Returnerer en sekvens af element- eller attributnoder, der har en IDREF-værdi, der er lig værdien af en eller flere af de værdier specificeret i strengargumentet |
fn:doc(URI) | |
fn:doc-available(URI) | Hvis doc() funktionen returnerer en dokumentnode, returneres true, ellers returneres false. |
|
Kontekstfunktioner
Navn | Beskrivelse |
---|---|
fn:position() |
Retur index-positionen for den nuværende behandlede node. Eksempel: //book[position()<=3] Resultat: Vælg de første tre book elementer |
fn:last() |
Retur antallet af elementer i den behandlede nodeliste. Eksempel: //book[last()] Resultat: Vælg den sidste book element |
fn:current-dateTime() | Retur nuværende dateTime (med tidszone). |
fn:current-date() | Retur nuværende dato (med tidszone). |
fn:current-time() | Retur nuværende tid (med tidszone). |
fn:implicit-timezone() | Retur implicit tidszone værdien. |
fn:default-collation() | Retur standard sammenligning værdien. |
fn:static-base-uri() | Retur base-uri værdien. |
- Forrige Side XPath Opsummering
- Næste Side XPath Læringsressourcer