XPath, XQuery och XSLT-funktioner

• fn:base-uri()
• fn:base-uri(node)

• fn:error()
• fn:error(error)
• fn:error(error,description)
• fn:error(error,description,error-object)

exempel:error(fn:QName('http://example.com/test', 'err:toohigh'), 'Error: Price is too high')

resultat: returnerar till den externa behandlingsmiljön http://example.com/test#toohigh samt strängen "Error: Price is too high".

returnerar det numeriska värdet av argumentet. Argumentet kan vara ett booleskt värde, en sträng eller en nodsamling.

exempel:number('100')

resultat: 100

returnerar det absoluta värdet av argumentet.

exempel:abs(3.14)

resultat: 3.14

exempel:abs(-3.14)

resultat: 3.14

returnerar det minsta heltal som är större än num-argumentet.

exempel:ceiling(3.14)

Resultat: 4

Returnerar det största heltalet som är mindre än eller lika med num-argumentet.

Exempel: floor(3.14)

Resultat: 3

Rundar num-argumentet till närmaste heltal.

Exempel: round(3.14)

Resultat: 3

Exempel: round-half-to-even(0.5)

Resultat: 0

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

Resultat: 2

Exempel: round-half-to-even(2.5)

Resultat: 2

Returnerar den strängvärde som är förknippat med argumentet. Argumentet kan vara ett nummer, ett logiskt värde eller en nodsamling.

Exempel: string(314)

Resultat: "314"

Returnerar strängen baserat på en sekvens av teckenpunkter.

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

Resultat: 'Thérèse'

Returnerar en sekvens av teckenpunkter baserat på strängen.

Exempel: string-to-codepoints("Thérèse")

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

• fn:compare(comp1,comp2)
• fn:compare(comp1,comp2,collation)

Om comp1 är mindre än comp2, returneras -1. Om comp1 är lika med comp2, returneras 0. Om comp1 är större än comp2, returneras 1. (Baserat på den använda jämförelseregeln).

Exempel: compare('ghi', 'ghi')

Resultat: 0

Returnerar sammansättning av strängar.

Exempel: concat('XPath ','är ','kul!')

Resultat: 'XPath är kul!'

Använd sep-parametret som separator för att returnera sammansatta strängar från string-argumentet.

Exempel: string-join(('We', 'are', 'having', 'fun!'), ' ')

Resultat: ' We are having fun! '

Exempel: string-join(('We', 'are', 'having', 'fun!'))

Resultat: 'Wearehavingfun!'

Exempel: string-join((), 'sep')

Resultat: ''

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

Returnerar en understräng av angiven längd som börjar vid start-positionen. Första tecknets index är 1. Om len-parametret utelämnas, returneras understrängen från position start till strängens slut.

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

Resultat: 'Beat'

Exempel: substring('Beatles',2)

Resultat: 'eatles'

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

Returnerar längden på den angivna strängen. Om det inte finns ett string-argument, returneras längden på den aktuella nodens strängvärde.

Exempel: string-length('Beatles')

Resultat: 7

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

Tar bort angiven strängs början och slut, och ersätter alla inre blankstegsserier med en, och returnerar resultatet. Om det inte finns ett string-argument, behandlas den aktuella noden.

Exempel: normalize-space(' The　　　XML ')

Resultat: 'The XML'

Konverterar string-argumentet till stora bokstäver.

Exempel: upper-case('The XML')

Resultat: 'THE XML'

Konverterar string-argumentet till små bokstäver.

Exempel: lower-case('The XML')

Resultat: 'the xml'

Replace string2 in string1 with string3.

Example: translate('12:30','30','45')

Result: '12:45'

Example: translate('12:30','03','54')

Result: '12:45'

Example: translate('12:30','0123','abcd')

Result: 'bc:da'

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

Result: "http%3A%2F%2Fexample.com%2Ftest#car"

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

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

Example: escape-uri ("http://example.com/~bébé", false())

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

If string1 contains string2, return true, otherwise return false.

Example: contains('XML','XM')

Resultat: true

If string1 starts with string2, return true, otherwise return false.

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

Resultat: true

If string1 ends with string2, return true, otherwise return false.

Example: ends-with('XML','X')

Resultat: false

Return the substring before the occurrence of string2 in string1.

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

Result: '12'

Return the substring after the occurrence of string2 in string1.

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

Resultat: '10'

Om string-argumentet matchar det angivna mönstret returneras true, annars returneras false.

Exempel: matches("Merano", "ran")

Resultat: true

Ersätt den angivna mönstret med replace-argumentet och returnera resultatet.

Exempel: replace("Bella Italia", "l", "*")

Resultat: 'Be**a Ita*ia'

Exempel: replace("Bella Italia", "l", "")

Resultat: 'Bea Itaia'

Exempel: tokenize("XPath is fun", "\s+")

Resultat: ("XPath", "is", "fun")

Först återställer boolean() -funktionen parametern till en boolesk värde. Om det booleska värdet är false, returneras true, annars returneras true.

Exempel: not(true())

Resultat: false

Returnerar booleska värdet true.

Exempel: true()

Resultat: true

Returnerar booleska värdet false.

Exempel: false()

Resultat: false

Återger det lokala värdet för argumentet som ett heltal som representerar åren.

Exempel: year-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Resultat: 2005

Återger det lokala värdet för argumentet som ett heltal som representerar månaderna.

Exempel: month-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Resultat: 01

Återger det lokala värdet för argumentet som ett heltal som representerar dagarna.

Exempel: day-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Resultat: 10

Återger det lokala värdet för argumentet som ett heltal som representerar timmarna.

Exempel: hours-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Resultat: 12

Återger det lokala värdet för argumentet som ett heltal som representerar minuterna.

Exempel: minutes-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Resultat: 30

Återger det lokala värdet för argumentet som ett decimaltal som representerar sekunderna.

Exempel: seconds-from-dateTime(xs:dateTime("2005-01-10T12:30:00-04:10"))

Resultat: 0

Återger det lokala värdet för argumentet som ett heltal som representerar året.

Exempel: year-from-date(xs:date("2005-04-23"))

Resultat: 2005

Returnerar det heltal som representerar månaden i det lokala värdet av argumentet.

Exempel: month-from-date(xs:date("2005-04-23"))

Resultat: 4

Returnerar det heltal som representerar dagen i det lokala värdet av argumentet.

Exempel: day-from-date(xs:date("2005-04-23"))

Resultat: 23

Returnerar det heltal som representerar timdelen i det lokala värdet av argumentet.

Exempel: hours-from-time(xs:time("10:22:00"))

Resultat: 10

Returnerar det heltal som representerar minutdelen i det lokala värdet av argumentet.

Exempel: minutes-from-time(xs:time("10:22:00"))

Resultat: 22

Returnerar det heltal som representerar sekunddelen i det lokala värdet av argumentet.

Exempel: seconds-from-time(xs:time("10:22:00"))

Resultat: 0

• fn:name()
• fn:name(nodeset)

• fn:local-name()
• fn:local-name(nodeset)

• fn:namespace-uri()
• fn:namespace-uri(nodeset)

Om språket för den aktuella noden matchar det specificerade språket returneras true.

Exempel: Lang("en") är sant för <p xml:lang="en">...</p>

Exempel: Lang("de") är falskt för <p xml:lang="en">...</p>

• fn:root()
• fn:root(node)

Returnerar positionen för element i projektsekvensen som är lika med searchitem-argumentet.

Exempel: index-of ((15, 40, 25, 40, 10), 40)

Resultat: (2, 4)

Exempel: index-of (("a", "dog", "and", "a", "duck"), "a")

Resultat (1, 4)

Exempel: index-of ((15, 40, 25, 40, 10), 18)

Resultat: ()

Returnerar en ny sekvens konstruerad av item-argumentet - och tar bort det projekt som specificeras av position-argumentet.

Exempel: remove(("ab", "cd", "ef"), 0)

Resultat: ("ab", "cd", "ef")

Exempel: remove(("ab", "cd", "ef"), 1)

Resultat: ("cd", "ef")

Exempel: remove(("ab", "cd", "ef"), 4)

Resultat: ("ab", "cd", "ef")

Om parametervärdet är en tom sekvens returneras true, annars returneras false.

Exempel: empty(remove(("ab", "cd"), 1))

Resultat: false

Om parametervärdet inte är en tom sekvens returneras true, annars returneras false.

Exempel: exists(remove(("ab"), 1))

Resultat: false

Returnerar unika värden.

Exempel: distinct-values((1, 2, 3, 1, 2))

Resultat: (1, 2, 3)

Returnerar en ny sekvens konstruerad av item-argumentet, och värdet vid pos-argumentet specificerar platsen där inserts-argumentets värde ska infogas.

Exempel: insert-before(("ab", "cd"), 0, "gh")

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

Exempel: insert-before(("ab", "cd"), 1, "gh")

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

Exempel: insert-before(("ab", "cd"), 2, "gh")

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

Exempel: insert-before(("ab", "cd"), 5, "gh")

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

Returnerar den omvända ordningen av de specificerade projekten.

Exempel: reverse(("ab", "cd", "ef"))

Resultat: ("ef", "cd", "ab")

Exempel: reverse(("ab"))

Resultat: ("ab")

Returnerar en projektsekvens som specificerats av start-argumentet, och längden på sekvensen specificeras av len-argumentet. Positionen för den första projektet är 1.

Exempel: subsequence(($item1, $item2, $item3,...), 3)

Resultat: ($item3, ...)

Exempel: subsequence(($item1, $item2, $item3, ...), 2, 2)

Resultat: ($item2, $item3)

Returnerar det genomsnittliga värdet av argumenten.

Exempel: avg((1,2,3))

Resultat: 2

Returnerar argument som är större än andra argument.

Exempel: max((1,2,3))

Resultat: 3

Exempel: max(('a', 'k'))

Resultat: 'k'

Returnerar argument som är mindre än andra argument.

Exempel: min((1,2,3))

Resultat: 1

Exempel: min(('a', 'k'))

Resultat: 'a'

• fn:collection()
• fn:collection(string)

Returnera index-positionen för den aktuella noden som behandlas.

Exempel: //book[position()<=3]

Resultat: Välj de första tre book-elementen

Returnera antalet objekt i den behandlade nodlistan.

Exempel: //book[last()]

Resultat: Välj den sista book-elementet