XPath, XQuery og XSLT Funktioner

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.
  • fn:base-uri()
  • fn:base-uri(node)
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
  • fn:error()
  • fn:error(error)
  • fn:error(error,description)
  • fn:error(error,description,error-object)

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.
  • fn:compare(comp1,comp2)
  • fn:compare(comp1,comp2,collation)

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: ''

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

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'

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

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

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

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
  • fn:name()
  • fn:name(nodeset)
Returnerer navnet på den aktuelle node eller den første node i den specificerede nodegruppe.
  • fn:local-name()
  • fn:local-name(nodeset)
Returnerer navnet på den aktuelle node eller den første node i den specificerede nodegruppe - uden navnerumpræfiks.
  • fn:namespace-uri()
  • fn:namespace-uri(nodeset)
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>

  • fn:root()
  • fn:root(node)
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.
  • fn:collection()
  • fn:collection(string)
 

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.