XPath, XQuery, and XSLT Functions
- Previous Page XPath Summary
- Next Page XPath Tutorial
Acces-functies
Name | Description |
---|---|
fn:node-name(node) | Geef de naam van de node van het argument terug. |
fn:nilled(node) | Geef de boolean waarde terug die aangeeft of het argument een genulde node is. |
fn:data(item.item,...) | Accepteert een item-sequentie en retourneert een atomaire waarde-sequentie. |
|
Geef de waarde van de base-uri eigenschap van de huidige of gespecificeerde node terug. |
fn:document-uri(node) | Geef de waarde van de document-uri eigenschap van de gespecificeerde node terug. |
Fout- en trace-functies
Name | Description |
---|---|
|
Voorbeeld: error(fn:QName('http://example.com/test', 'err:toohigh'), 'Error: Price is too high') Resultaat: Retourneert http://example.com/test#toohigh aan het externe verwerkingsmilieu en de string "Error: Price is too high". |
fn:trace(value,label) | Gebruikt om de debug van de query uit te voeren. |
Functies voor numerieke waarden
Name | Description |
---|---|
fn:number(arg) |
Geef de numerieke waarde van het argument. Het argument kan een boolean, string of node-set zijn. Voorbeeld: number('100') Resultaat: 100 |
fn:abs(num) |
Geef de absolute waarde van het argument. Voorbeeld: abs(3.14) Resultaat: 3.14 Voorbeeld: abs(-3.14) Resultaat: 3.14 |
fn:ceiling(num) |
Geef het kleinste gehele getal dat groter is dan het num argument. Voorbeeld: ceiling(3.14) Resultaat: 4 |
fn:floor(num) |
Geef de grootste integer terug die niet groter is dan het num parameter. Voorbeeld: floor(3.14) Resultaat: 3 |
fn:round(num) |
Rond het num parameter af naar het dichtstbijzijnde gehele getal. Voorbeeld: round(3.14) Resultaat: 3 |
fn:round-half-to-even() |
Voorbeeld: round-half-to-even(0.5) Resultaat: 0 Voorbeeld: round-half-to-even(1.5) Resultaat: 2 Voorbeeld: round-half-to-even(2.5) Resultaat: 2 |
Over stringfuncties
Name | Description |
---|---|
fn:string(arg) |
Geef de stringwaarde van het argument terug. Het argument kan een getal, een logische waarde of een knooppuntenset zijn. Voorbeeld: string(314) Resultaat: "314" |
fn:codepoints-to-string(int,int,...) |
Geef de string terug op basis van de codepoint reeks. Voorbeeld: codepoints-to-string(84, 104, 233, 114, 232, 115, 101) Resultaat: 'Thérèse' |
fn:string-to-codepoints(string) |
Geef de codepoint reeks terug op basis van de string. Voorbeeld: string-to-codepoints("Thérèse") Resultaat: 84, 104, 233, 114, 232, 115, 101 |
fn:codepoint-equal(comp1,comp2) | Op basis van de Unicode codepoint vergelijking, als de waarde van comp1 gelijk is aan de waarde van comp2, dan wordt true geretourneerd. (http://www.w3.org/2005/02/xpath-functions/collation/codepoint), anders wordt false geretourneerd. |
|
Als comp1 kleiner is dan comp2, dan wordt -1 geretourneerd. Als comp1 gelijk is aan comp2, dan wordt 0 geretourneerd. Als comp1 groter is dan comp2, dan wordt 1 geretourneerd. (Afhankelijk van het gebruikte vergelijkingsregels). Voorbeeld: compare('ghi', 'ghi') Resultaat: 0 |
fn:concat(string,string,...) |
Geef de samenvoeging van de string terug. Voorbeeld: concat('XPath ','is ','FUN!') Resultaat: 'XPath is FUN!' |
fn:verbinden((string,string,...),scheidingsmerk) |
Uses the sep parameter as a separator to return the concatenated string of the string parameter. Example: string-join(('We', 'are', 'having', 'fun!'), ' ') Result: ' We are having fun! ' Example: string-join(('We', 'are', 'having', 'fun!')) Result: 'Wearehavingfun!' Example: string-join((), 'sep') Result: '' |
|
Returns a substring of the specified length starting from the start position. The index of the first character is 1. If the len parameter is omitted, it returns the substring from position start to the end of the string. Example: substring('Beatles',1,4) Result: 'Beat' Example: substring('Beatles',2) Result: 'eatles' |
|
Returns the length of the specified string. If no string parameter is provided, it returns the length of the string value of the current node. Example: string-length('Beatles') Result: 7 |
|
Removes the leading and trailing whitespace of the specified string, replaces all internal white space sequences with one, and then returns the result. If no string parameter is provided, it processes the current node. Example: normalize-space(' The XML ') Result: 'The XML' |
fn:normalize-unicode() | Executes Unicode normalization. |
fn:upper-case(string) |
Converts the string parameter to uppercase. Example: upper-case('The XML') Result: 'THE XML' |
fn:lower-case(string) |
Converts the string parameter to lowercase. Example: lower-case('The XML') Result: 'the xml' |
fn:translate(string1,string2,string3) |
Vervang string2 in string1 door string3. Voorbeeld: translate('12:30','30','45') Resultaat: '12:45' Voorbeeld: translate('12:30','03','54') Resultaat: '12:45' Voorbeeld: translate('12:30','0123','abcd') Resultaat: 'bc:da' |
fn:escape-uri(stringURI,esc-res) |
Voorbeeld: escape-uri("http://example.com/test#car", true()) Resultaat: "http%3A%2F%2Fexample.com%2Ftest#car" Voorbeeld: escape-uri("http://example.com/test#car", false()) Resultaat: "http://example.com/test#car" Voorbeeld: escape-uri ("http://example.com/~bébé", false()) Resultaat: "http://example.com/~b%C3%A9b%C3%A9" |
fn:contains(string1,string2) |
Als string1 string2 bevat, geef dan true terug, anders geef false terug. Voorbeeld: contains('XML','XM') Resultaat: true |
fn:starts-with(string1,string2) |
Als string1 begint met string2, geef dan true terug, anders geef false terug. Voorbeeld: starts-with('XML','X') Resultaat: true |
fn:ends-with(string1,string2) |
Als string1 eindigt op string2, geef dan true terug, anders geef false terug. Voorbeeld: ends-with('XML','X') Resultaat: false |
fn:substring-before(string1,string2) |
Geef het ondersteunde string2 in string1 voor het optreden van de substring. Voorbeeld: substring-before('12/10','/') Resultaat: '12' |
fn:substring-after(string1,string2) |
Geef het ondersteunde string2 in string1 na het optreden van de substring. Voorbeeld: substring-after('12/10','/') Resultaat: '10' |
fn:matches(string,pattern) |
Retourneert true als de string parameter overeenkomt met het opgegeven patroon, anders retourneert false. Voorbeeld: matches("Merano", "ran") Resultaat: true |
fn:replace(string,pattern,replace) |
Vervangt de opgegeven patroon door de replace parameter en retourneert het resultaat. Voorbeeld: replace("Bella Italia", "l", "*") Resultaat: 'Be**a Ita*ia' Voorbeeld: replace("Bella Italia", "l", "") Resultaat: 'Bea Itaia' |
fn:tokenize(string,pattern) |
Voorbeeld: tokenize("XPath is fun", "\s+") Resultaat: ("XPath", "is", "fun") |
Functies voor anyURI.
Name | Description |
---|---|
fn:resolve-uri(relative,base) |
Functies met betrekking tot booleaanse waarden.
Name | Description |
---|---|
fn:boolean(arg) | Retourneert de booleaanse waarde van een getal, string of node-set. |
fn:not(arg) |
Maakt eerst het argument hersteld tot een booleaanse waarde met de boolean() functie. Retourneert true als de booleaanse waarde false is, anders retourneert true. Voorbeeld: not(true()) Resultaat: false |
fn:true() |
Retourneert de booleaanse waarde true. Voorbeeld: true() Resultaat: true |
fn:false() |
Retourneert de booleaanse waarde false. Voorbeeld: false() Resultaat: false |
Functies met betrekking tot duur, datum en tijd.
Functie voor het extraheren van componenten van datum, tijd en duur.
Name | Description |
---|---|
fn:dateTime(date,time) | Converteert de parameter naar een datum en tijd. |
fn:years-from-duration(datetimedur) | Retourneert het jaargezel van het argument als een geheel getal, weergegeven in standaard woordverbalisatie. |
fn:months-from-duration(datetimedur) | Retourneert het maanddeel van het argument als een geheel getal, weergegeven in standaard woordverbalisatie. |
fn:days-from-duration(datetimedur) | Retourneert het dagdeel van het argument als een geheel getal, weergegeven in standaard woordverbalisatie. |
fn:hours-from-duration(datetimedur) | Geef het hele getal dat het uren deel van de waarde representeren, weergegeven in de standaard woordenschat. |
fn:minutes-from-duration(datetimedur) | Geef het hele getal dat het minuten deel van de waarde representeren, weergegeven in de standaard woordenschat. |
fn:seconds-from-duration(datetimedur) | Geef het decimale getal dat het minuten deel van de waarde representeren, weergegeven in de standaard woordenschat. |
fn:year-from-dateTime(datetime) |
Geef het hele getal dat het jaren deel van het lokale waarde representeren. Voorbeeld: year-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10")) Resultaat: 2005 |
fn:month-from-dateTime(datetime) |
Geef het hele getal dat het maanden deel van het lokale waarde representeren. Voorbeeld: month-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10")) Resultaat: 01 |
fn:day-from-dateTime(datetime) |
Geef het hele getal dat het dagen deel van het lokale waarde representeren. Voorbeeld: day-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10")) Resultaat: 10 |
fn:hours-from-dateTime(datetime) |
Geef het hele getal dat het uren deel van het lokale waarde representeren. Voorbeeld: hours-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10")) Resultaat: 12 |
fn:minutes-from-dateTime(datetime) |
Geef het hele getal dat het minuten deel van het lokale waarde representeren. Voorbeeld: minutes-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10")) Resultaat: 30 |
fn:seconds-from-dateTime(datetime) |
Geef het decimale getal dat het seconden deel van het lokale waarde representeren. Voorbeeld: seconds-from-dateTime(xs:dateTime("2005-01-10T12:30:00-04:10")) Resultaat: 0 |
fn:timezone-from-dateTime(datetime) | Retourneert de tijdzone van het parameter, indien aanwezig. |
fn:year-from-date(date) |
Geef het lokale getal dat het jaar representeren. Voorbeeld: year-from-date(xs:date("2005-04-23")) Resultaat: 2005 |
fn:month-from-date(date) |
Retourneert het integer dat de maandrepresentatie van de lokale waarde van het parameter aangeeft. Voorbeeld: month-from-date(xs:date("2005-04-23")) Resultaat: 4 |
fn:day-from-date(date) |
Retourneert het integer dat de dagrepresentatie van de lokale waarde van het parameter aangeeft. Voorbeeld: day-from-date(xs:date("2005-04-23")) Resultaat: 23 |
fn:timezone-from-date(date) | Retourneert de tijdzone van het parameter, indien aanwezig. |
fn:hours-from-time(time) |
Retourneert het integer dat de urenrepresentatie van de lokale waarde van het parameter aangeeft. Voorbeeld: hours-from-time(xs:time("10:22:00")) Resultaat: 10 |
fn:minutes-from-time(time) |
Retourneert het integer dat de minutenrepresentatie van de lokale waarde van het parameter aangeeft. Voorbeeld: minutes-from-time(xs:time("10:22:00")) Resultaat: 22 |
fn:seconds-from-time(time) |
Retourneert het integer dat de sekondenrepresentatie van de lokale waarde van het parameter aangeeft. Voorbeeld: seconds-from-time(xs:time("10:22:00")) Resultaat: 0 |
fn:timezone-from-time(time) | Retourneert de tijdzone van het parameter, indien aanwezig. |
fn:adjust-dateTime-to-timezone(datetime,timezone) | Retourneert dateTime zonder tijdzone als het timezone parameter leeg is. Anders retourneert het dateTime met tijdzone. |
fn:adjust-date-to-timezone(date,timezone) | Retourneert date zonder tijdzone als het timezone parameter leeg is. Anders retourneert het date met tijdzone. |
fn:adjust-time-to-timezone(time,timezone) | Retourneert time zonder tijdzone als het timezone parameter leeg is. Anders retourneert het time met tijdzone. |
Functies gerelateerd aan QNames
Name | Description |
---|---|
fn:QName() | |
fn:local-name-from-QName() | |
fn:namespace-uri-from-QName() | |
fn:namespace-uri-for-prefix() | |
fn:in-scope-prefixes() | |
fn:resolve-QName() |
Functies over knooppunten
Name | Description |
---|---|
|
Retourneert de naam van het huidige knooppunt of de eerste knooppunt in de opgegeven knooppuntverzameling. |
|
Retourneert de naam van het huidige knooppunt of de eerste knooppunt in de opgegeven knooppuntverzameling - zonder namespace voorvoegsel. |
|
Retourneert de namespace URI van de huidige knooppunt of de eerste knooppunt in de opgegeven knooppuntverzameling. |
fn:lang(lang) |
Retourneert true als de taal van het huidige knooppunt overeenkomt met de opgegeven taal. Voorbeeld: Lang("en") is true voor <p xml:lang="en">...</p> Voorbeeld: Lang("de") is false voor <p xml:lang="en">...</p> |
|
Retourneert de wortel van het knooppuntengeslacht van de huidige knooppunt of het opgegeven knooppunt. Dit is meestal de documentknooppunt. |
Functies voor reeksen
Algemene functie
Name | Description |
---|---|
fn:index-of((item,item,...),searchitem) |
Retourneert de positie van het item in de item reeks dat gelijk is aan de searchitem parameter. Voorbeeld: index-of ((15, 40, 25, 40, 10), 40) Resultaat: (2, 4) Voorbeeld: index-of (("a", "dog", "and", "a", "duck"), "a") Resultaat (1, 4) Voorbeeld: index-of ((15, 40, 25, 40, 10), 18) Resultaat: () |
fn:remove((item,item,...),position) |
Retourneert een nieuwe reeks gevormd door de item parameter - verwijderd de item op de opgegeven positie. Voorbeeld: remove(("ab", "cd", "ef"), 0) Resultaat: ("ab", "cd", "ef") Voorbeeld: remove(("ab", "cd", "ef"), 1) Resultaat: ("cd", "ef") Voorbeeld: remove(("ab", "cd", "ef"), 4) Resultaat: ("ab", "cd", "ef") |
fn:empty(item,item,...) |
Als de parameterwaarde een lege reeks is, wordt true geretourneerd, anders wordt false geretourneerd. Voorbeeld: empty(remove(("ab", "cd"), 1)) Resultaat: false |
fn:exists(item,item,...) |
Retourneert true als de parameterwaarde niet een lege reeks is, anders retourneert het false. Voorbeeld: exists(remove(("ab"), 1)) Resultaat: false |
fn:distinct-values((item,item,...),collation) |
Retourneert unieke waarden. Voorbeeld: distinct-values((1, 2, 3, 1, 2)) Resultaat: (1, 2, 3) |
fn:insert-before((item,item,...),pos,inserts) |
Retourneert een nieuwe reeks die is opgebouwd uit de item parameter - met de waarde van de inserts parameter ingevoegd op de positie gespecificeerd door het pos parameter. Voorbeeld: insert-before(("ab", "cd"), 0, "gh") Resultaat: ("gh", "ab", "cd") Voorbeeld: insert-before(("ab", "cd"), 1, "gh") Resultaat: ("gh", "ab", "cd") Voorbeeld: insert-before(("ab", "cd"), 2, "gh") Resultaat: ("ab", "gh", "cd") Voorbeeld: insert-before(("ab", "cd"), 5, "gh") Resultaat: ("ab", "cd", "gh") |
fn:reverse((item,item,...)) |
Retourneert de omgekeerde volgorde van de gespecificeerde items. Voorbeeld: reverse(("ab", "cd", "ef")) Resultaat: ("ef", "cd", "ab") Voorbeeld: reverse(("ab")) Resultaat: ("ab") |
fn:subsequence((item,item,...),start,len) |
Retourneert een reeks van items die begint bij de positie gespecificeerd door het start parameter en heeft een lengte die wordt gespecificeerd door het len parameter. De positie van het eerste item is 1. Voorbeeld: subsequence(($item1, $item2, $item3,...), 3) Resultaat: ($item3, ...) Voorbeeld: subsequence(($item1, $item2, $item3, ...), 2, 2) Resultaat: ($item2, $item3) |
fn:unordered((item,item,...)) | Retourneert de items in de volgorde die door de implementatie wordt bepaald. |
Testfunctie voor de capaciteit van de reeks
Name | Description |
---|---|
fn:zero-or-one(item,item,...) | Retourneert het argument als het geen of één item bevat, anders genereert het een fout |
fn:one-or-more(item,item,...) | Retourneert het argument als het een of meer items bevat, anders genereert het een fout |
fn:exactly-one(item,item,...) | Retourneert het argument als het een item bevat, anders genereert het een fout |
Gelijkheid, Unie, Intersection en Uitsluiting
Name | Description |
---|---|
fn:deep-equal(param1,param2,collation) | Retourneert true als param1 en param2 gelijk zijn (deep-equal), anders retourneert het false |
Totaleringsfunctie
Name | Description |
---|---|
fn:count((item,item,...)) | Retourneert het aantal nodes |
fn:avg((arg,arg,...)) |
Retourneert het gemiddelde van de waarden van de parameters Voorbeeld: avg((1,2,3)) Resultaat: 2 |
fn:max((arg,arg,...)) |
Retourneert het argument dat groter is dan de andere parameters Voorbeeld: max((1,2,3)) Resultaat: 3 Voorbeeld: max(('a', 'k')) Resultaat: 'k' |
fn:min((arg,arg,...)) |
Retourneert het argument dat kleiner is dan de andere parameters Voorbeeld: min((1,2,3)) Resultaat: 1 Voorbeeld: min(('a', 'k')) Resultaat: 'a' |
fn:sum(arg,arg,...) | Retourneert de som van de waarden van elke node in de gespecificeerde node-set |
Functie die een sequentie genereert
Name | Description |
---|---|
fn:id((string,string,...),node) | Retourneert een sequentie van elementnodes die een ID-waarde hebben die gelijk is aan de waarde van een of meer van de waarden gespecificeerd in de string-argument |
fn:idref((string,string,...),node) | Retourneert een sequentie van element- of attribuutnodes die een IDREF-waarde hebben die gelijk is aan de waarde van een of meer van de waarden gespecificeerd in de string-argument |
fn:doc(URI) | |
fn:doc-available(URI) | If the doc() function returns a document node, it returns true, otherwise it returns false. |
|
Context Functions
Name | Description |
---|---|
fn:position() |
Return the index position of the current node being processed. Example: //book[position()<=3] Result: Select the first three book elements |
fn:last() |
Return the number of items in the list of nodes being processed. Example: //book[last()] Result: Select the last book element |
fn:current-dateTime() | Return the current dateTime (with timezone). |
fn:current-date() | Return the current date (with timezone). |
fn:current-time() | Return the current time (with timezone). |
fn:implicit-timezone() | Return the value of the implicit timezone. |
fn:default-collation() | Return the value of the default collation. |
fn:static-base-uri() | Return the value of base-uri. |
- Previous Page XPath Summary
- Next Page XPath Tutorial