Latest web development tutorials

XPath, XQuery i funkcje XSLT

Poniższa instrukcja odniesienia definiuje funkcje XPath 2.0, XQuery 1.0 i XSLT 2.0.


Funkcja Reference Manual

uwaga Domyślną funkcją namespace prefix dla fn:

uwaga Funkcja nazw URI jest: http://www.w3.org/2005/xpath-functions

funkcja dostępu

nazwa wyjaśnienie
fn: Nazwa węzła (węzłów) Zwraca węzeł nazwa węzła parametru.
fn: nilled (node) Zwraca czy odrzucić węzła argumentu wartość logiczną.
Fn: Dane (item.item, ...) Zebrane sekwencję projektu i zwraca sekwencję wartości atomowych.
  • fn: base-uri ()
  • fn: base-uri (node)
Zwraca wartość bieżącego atrybutu bazowego-uri określa węzeł lub węzły.
fn: Dokument-uri (node) Zwraca wartość określonej właściwości dokumentu-uri węzła.

Błędy i funkcje śledzenia

nazwa wyjaśnienie
  • fn: error ()
  • fn: error (błąd)
  • fn: error (błąd, opis)
  • fn: error (błąd, opis błędu-object)

Przykłady: error (fn: QName ( "http://example.com/test ',' err: toohigh '),' Błąd: Cena jest zbyt wysoka")

Wyniki: Powroty http://example.com/test#toohigh~~number=plural i sznurki do środowiska przetwarzania zewnętrznego "Błąd: cena jest zbyt wysoka".

fn: trace (wartość, etykieta) Jest on używany do kwerendy debug.

Wartości funkcji związanych

nazwa wyjaśnienie
fn: numer (Arg)

Zwraca się parametru. Parametr jest wartością logiczną, łańcuch, lub zbioru węzłów.

Przykłady: numer ( "100")

Wyniki: 100

fn: abs (num)

Zwraca wartość bezwzględną parametru.

Przykłady: ABS (3.14)

Wyniki: 3.14

Przykłady: ABS (-3.14)

Wyniki: 3.14

fn: ceiling (num)

Zwraca najmniejszą liczbę całkowitą większą niż parametr num.

Przykłady: sufit (3.14)

Wyniki: 4

fn: podłoga (num)

Zwraca największą liczbę całkowitą nie większą niż parametr num.

Przykłady: piętro (3.14)

Wyniki: 3

fn: round (num)

Num argumentem w zaokrągleniu do najbliższej liczby całkowitej.

Przykłady: round (3.14)

Wyniki: 3

fn: round-pół do nawet ()

Przykłady: okrągłe pół do nawet (0,5)

Wyniki: 0

Przykłady: okrągłe pół do nawet (1,5)

Wyniki: 2

Przykłady: okrągłe pół do nawet (2.5)

Wyniki: 2

Funkcje o strunach

nazwa wyjaśnienie
fn: string (arg)

Zwraca ciąg wartości parametru. Argumenty mogą być liczby, wartości logiczne lub zestaw węzłów.

Przykłady: string (314)

Wynik: "314"

Fn: codepoints na ciąg znaków (int, int, ...)

Według kolejności punkt kodu zwraca ciąg znaków.

Przykłady: codepoints na ciąg znaków (84, 104, 233, 114, 232, 115, 101)

Wyniki: "Teresa"

fn: string do codepoints (string)

Według powrotnej ciąg sekwencji punkcie kodowym.

Przykłady: string do codepoints ( "Teresa")

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

fn: punkt kodowy równy (KOMP1, Comp2) Według porównania punkt kodowy Unicode, jeśli wartość jest równa wartości Comp1 Comp2 Zwraca true. (Http://www.w3.org/2005/02/xpath-functions/collation/codepoint), w przeciwnym razie zwraca false.
  • fn: porównanie (KOMP1, Comp2)
  • fn: porównanie (KOMP1, Comp2, zestawień)

Jeśli KOMP1 mniej niż Comp2 zwracane jest -1. Jeśli Comp1 równego Comp2, zwracane jest 0. Jeśli Comp1 większa niż Comp2, 1 jest zwracany. (Zgodnie z zasadami stosowanymi przez kontrolę).

Przykład: porównanie ( 'ghi "," ghi ")

Wyniki: 0

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

Zwraca połączenie ciągów.

Przykłady: concat ( 'XPath "," jest "," FUN! ")

Wyniki: 'XPath jest zabawa!

fn: string-join ((string, string, ...), wrzesień)

Użyj sie jako argument ogranicznika powrócić ciąg parametru ciąg po szwy.

Przykłady: string-join ( '! Bawić "(" My "," to "," o',), '')

Wyniki: "Jesteśmy zabawy!

Przykłady: string-join ( '! Bawić "(" My "," to "," o "))

Wyniki: 'Wearehavingfun!

Przykłady: string-join ((), 'lis')

Wyniki: ''

  • fn: podciąg (string, start, len)
  • fn: podciąg (łańcuch, start)

Zwraca podciąg z pozycji startowej na początku określonej długości. Indeks pierwszego znaku jest 1. Jeśli pominąć argumentu len z położenia początkowego do końca ciąg jest zwracany.

Przykłady: podciąg ( 'The Beatles', 1,4)

Wyniki: "beat"

Przykłady: podciąg ( "The Beatles", 2)

Wyniki: '' eatles

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

Zwraca długość łańcucha. Jeśli nie ma argumentu łańcuch, długość wartości ciągu bieżącego węzła jest zwracana.

Przykłady: string-length ( 'The Beatles')

Wyniki: 7

  • fn: normalizować-space (string)
  • fn: normalizować-space ()

Usuń początek i koniec określonym ciągiem pustym, pustym i wszystkie zastąpiona przez szereg wewnętrznych i zwraca wynik. Jeśli nie ma argumentu ciąg proces bieżącego węzła.

Przykłady: normalizować przestrzeni ( "XML")

Wyniki: "XML"

fn: normalizować-unicode () Realizacja normalizacji Unicode.
fn: dużymi literami (string)

Argument Łańcuch na wielkie litery.

Przykłady: dużymi literami ( "XML")

Wyniki: "xml"

fn: małymi literami (string)

Argument łańcuch konwertowane na małe litery.

Przykłady: małą literą ( "XML")

Wyniki: "xml"

fn: translate (łańcuch1, string2, String3)

Łańcuch1 w string2 zastąpiony String3.

Przykłady: translate ('12: 30 ',' 30 ',' 45 ')

Wyniki: '12: 45 '

Przykłady: translate ('12: 30 ',' 03 ',' 54 ')

Wyniki: '12: 45 '

Przykłady: translate ('12: 30 '' 0123 ',' abcd ')

Wyniki: 'bc: da "

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

Przykłady: uciec-uri ( "http://example.com/test#car", true ())

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

Przykłady: uciec-uri ( "http://example.com/test#car" false ())

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

Przykłady: uciec-uri ( "http://example.com/~bebe" false ())

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

fn: contains (łańcuch1, string2)

Jeśli łańcuch1 zawiera String2, to zwraca wartość true, w przeciwnym razie zwraca false.

Przykłady: contains ( 'XML', 'XM')

Wyniki: prawdziwe

Fn: starts-with (łańcuch1, string2)

Jeśli string1 rozpoczyna string2, to zwraca wartość true, w przeciwnym razie zwraca false.

Przykłady: starts-with ( 'XML', 'X')

Wyniki: prawdziwe

fn: kończy się-z (łańcuch1, string2)

Jeśli łańcuch1 z końcem String2 zwraca wartość true, w przeciwnym razie zwraca false.

Przykłady: końce-with XML ( '', 'X')

Wyniki: false

fn: substring-before (łańcuch1, string2)

Zwraca fragment łańcuch1 string2 stawienia się przed.

Przykłady: podciąg-before ('12 / 10 ',' / ')

Wyniki: '12 '

fn: substring-after (łańcuch1, string2)

Zwraca fragment łańcuch1 String2 pojawiają się później.

Przykłady: podciąg-po ('12 / 10 ',' / ')

Wyniki: '10 '

Fn: mecze (string, wzór)

Jeśli ciąg pasuje do określonego wzorca, to zwraca wartość true, w przeciwnym razie zwraca false.

Przykłady: tenis ( "Merano", "prowadził")

Wyniki: prawdziwe

fn: wymienić (łańcuch, wzór, wymień)

Wybrany tryb otrzymuje zastąpić parametr i zwraca wynik.

Przykłady: replace ( "Bella Italia", "L", "*")

Wyniki: 'Bądź ** a Ita * ia'

Przykłady: replace ( "Bella Italia", "l", "")

Wyniki: "Bea Itaia '

fn: tokenize (string, wzór)

Przykłady: tokenize ( "XPath jest zabawa", "\ s +")

Wyniki :( "XPath", "jest", "fun")

Funkcja anyURI dla

nazwa wyjaśnienie
fn: resolve-uri (względne, podstawa)

Funkcje wartości logicznych

nazwa wyjaśnienie
fn: Boolean (Arg) Zwraca wartość logiczną ciąg liczbowy, lub ustaw węzła.
fn: nie (Arg)

Po pierwsze, logiczna function (), aby przywrócić parametry wartości logicznej. Jeżeli wartość logiczna jest fałszywe, to zwraca wartość true, w przeciwnym wypadku zwraca wartość true.

Przykład: nie (true ())

Wyniki: false

fn: true ()

Zwraca wartość logiczną prawda.

Przykłady: true ()

Wyniki: prawdziwe

fn: false ()

Zwraca wartość logiczną FAŁSZ.

Przykłady: false ()

Wyniki: false

Funkcje związane z czasem trwania, data i czas

Data, godzina, czas trwania funkcji ekstrakcji komponenty

nazwa wyjaśnienie
fn: dateTime (data, godzina) Argumenty data i czas.
Fn: lat-od czasu trwania (datetimedur) Część całkowita Roku zwracanej wartości standardowej notacji do reprezentowania słów.
Fn: miesiąc-from-trwania (datetimedur) Zwraca część całkowitą wartości parametrów miesiąca standardowej notacji do reprezentowania słów.
Fn: dni-od czasu trwania (datetimedur) Zwraca część całkowitą wartości parametrów dnia, standardowej notacji do reprezentowania słów.
Fn: godziny-from-trwania (datetimedur) Zwraca część całkowitą wartości parametrów na godzinę, standardowej notacji do reprezentowania słów.
Fn: minuta-od czasu trwania (datetimedur) Zwraca część całkowitą protokole wartości parametrów, standardowa notacja do reprezentowania słów.
Fn: sekunda-od czasu trwania (datetimedur) Zwraca część dziesiętną liczby minut wcześniej parametrów, standardowej notacji do reprezentowania słów.
fn: lat-od-dateTime (datetime)

Zwraca wartości parametrów całkowitą w lokalnym punkcie.

Przykłady: lat-od-dateTime (xs: DateTime ( "2005-01-10T12: 30-04: 10"))

Wyniki: 2005

fn: miesiąc-z-dateTime (datetime)

Zwraca część całkowitą miesięcznych lokalnych wartości parametrów.

Przykłady: miesiąc-z-dateTime (xs: DateTime ( "2005-01-10T12: 30-04: 10"))

Wyniki: 01

fn: dzień-z-dateTime (datetime)

Zwraca część całkowitą Dnia lokalnych wartości parametrów.

Przykłady: dzień-z-dateTime (xs: DateTime ( "2005-01-10T12: 30-04: 10"))

Wyniki: 10

Fn: godziny-from-dateTime (datetime)

Zwraca część całkowitą godzinach wartości parametrów lokalnych.

Przykłady: godziny-z-dateTime (xs: DATETIME ( "2005-01-10T12: 30-04: 10"))

Wyniki: 12

Fn: minuta-od-dateTime (datetime)

Zwraca część całkowitą parametrów lokalnej wartości minut.

Przykłady: minuty-from-dateTime (xs: DateTime ( "2005-01-10T12: 30-04: 10"))

Wyniki: 30

Fn: sekunda-od-dateTime (datetime)

Zwraca część dziesiętną drugich lokalnych wartości parametrów.

Przykłady: sekunda-od-dateTime (xs: DATETIME ( "2005-01-10T12: 30: 00-04: 10"))

Wyniki: 0

fn: strefa czasowa-z-dateTime (datetime) Zwraca część regionu, jeśli są obecne.
fn: lat-od-date (data)

W zamian wartości całkowitych, które reprezentują lokalne parametry.

Przykłady: rok od aktualnych (xs: date ( "23.04.2005"))

Wyniki: 2005

fn: miesiąc-z-date (data)

Integer miesięcy Zwraca lokalną wartość parametru wskazanego.

Przykłady: miesiąc-z-daty (xs: date ( "23.04.2005"))

Wyniki: 4

fn: dzień-z-date (data)

Dzień powrotu liczbą całkowitą reprezentuje lokalną parametr.

Przykłady: dzień-z-daty (xs: date ( "23.04.2005"))

Wyniki: 23

fn: strefa czasowa, od aktualnych (data) Zwraca część regionu, jeśli są obecne.
Fn: godziny-z-time (czas)

Zwraca część całkowitą liczbę godzin lokalnych wartości parametrów reprezentowane.

Przykłady: godziny-z-time (xs: czas ( "10:22:00"))

Wyniki: 10

Fn: minuta-od-time (czas)

Zwraca część całkowitą parametrów lokalna wartość minut reprezentuje.

Przykłady: minuty-z-time (xs: czas ( "10:22:00"))

Wyniki: 22

Fn: sekunda-od-time (czas)

Część całkowita drugiej wartości zwracanej parametr wskazuje lokalny.

Przykłady: sekunda-od czasu (xs: czas ( "10:22:00"))

Wyniki: 0

fn: strefa czasowa-z-time (czas) Zwraca część regionu, jeśli są obecne.
fn: regulacja-dateTime do strefy czasowej (datetime, strefa czasowa) Jeśli argument strefa czasowa jest pusta, to nie zwraca strefę czasową datetime. W przeciwnym wypadku zwraca dateTime ze strefy czasowej.
fn: regulacja-Date-to-czasowej (data, strefa czasowa) Jeśli argument strefa czasowa jest pusta, to nie zwraca strefę czasową, datę. W przeciwnym wypadku zwraca datę ze strefy czasowej.
fn: regulacja-time-to-czasowej (czas, strefa czasowa) Jeśli argument strefa czasowa jest pusta, to nie zwraca strefę czasową czasu. W przeciwnym razie czas z strefy czasowej.

I QNames podobne funkcje

nazwa wyjaśnienie
fn: QName ()
fn: local-name-z-QName ()
fn: namespace-uri-z-QName ()
fn: namespace-uri-for-prefiks ()
fn: wpuszczony w zakresach przedrostków ()
fn: resolve-QName ()

Funkcja węzła

nazwa wyjaśnienie
  • fn: nazwy ()
  • fn: nazwy (zbiorze węzłów)
Zwraca bieżącą nazwę węzła lub określić pierwszy węzeł klastra.
  • fn: local-name ()
  • fn: local-name (zbiorze węzłów)
Zwraca pierwszy bieżącego węzła lub określić węzeł w klastrze - bez przedrostka przestrzeni nazw.
  • fn: namespace-uri ()
  • fn: namespace-uri (zbiorze węzłów)
Zwraca określony węzeł lub węzły w klastrze bieżącej przestrzeni nazw URI pierwszego węzła.
fn: lang (lang)

Jeśli język bieżącego węzła odpowiada określonym języku, to zwraca true.

Przykłady: Lang ( "en") odnosi się do <p xml: lang = "pl"> ... </ p>

Przykłady: Lang ( "de") jest fałszywe dla <p xml: lang = "pl"> ... </ p>

  • fn: root ()
  • fn: root (node)
Zwraca węzeł korzenia drzewa lub bieżącego węzła podany węzeł należy. Zwykle węzeł dokumentu.

Sekwencje Funkcje powiązane

funkcja Ogólne

nazwa wyjaśnienie
fn: indeks-of ((poz, poz ...), searchitem)

Powrót w projekcie równej parametrów searchitem pozycji sekwencji.

Przykłady: indeks-of ((15, 40, 25, 40, 10), 40)

Wyniki: (2, 4)

Przykłady: indeks-z (( "a", "pies", "i", "a", "kaczka"), "a")

Wynik (1, 4)

Przykłady: indeks-of ((15, 40, 25, 40, 10), 18)

Wyniki :()

fn: usunąć ((poz, poz ...), stanowisko)

Zwraca nowy ciąg konfiguracji parametrów elementu - usunięcie parametru położenie określa projekt.

Przykłady: usunąć (( "AB", "cd", "ef"), 0)

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

Przykłady: usunąć (( "AB", "cd", "ef") 1)

Wyniki :( "cd", "ef")

Przykłady: usunąć (( "AB", "cd", "ef"), 4)

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

fn: pusta (poz, poz ...)

Jeśli wartość parametru jest pusty ciąg, to zwraca wartość true, w przeciwnym razie zwraca false.

Przykłady: pusta (remove (( "AB", "CD"), 1))

Wyniki: false

fn: istnieje (poz, poz ...)

Jeśli wartość parametru nie jest pusty ciąg, to zwraca wartość true, w przeciwnym razie zwraca false.

Przykłady: istnieje (usuń (( "AB"), 1))

Wyniki: false

Fn: odrębne Wartości ((poz, poz ...), zestawień)

Jedynym zwracać różne wartości.

Przykłady: różne Wartości ((1, 2, 3, 1, 2))

Wyniki: (1, 2, 3)

fn: insert-before ((poz, poz ...), pos, wkładki)

Zwraca nową sekwencję wykonaną przez parametr pozycji - parametr określający położenie wkładania wkładki wartość parametru poz.

Przykłady: insert-before (( "AB", "CD"), 0, "GH")

Wyniki :( "gh", "ab", "CD")

Przykłady: insert-before (( "AB", "CD"), 1, "GH")

Wyniki :( "gh", "ab", "CD")

Przykłady: insert-before (( "AB", "CD"), 2, "GH")

Wyniki :( "ab", "gh", "CD")

Przykłady: insert-before (( "AB", "CD"), 5, "GH")

Wyniki :( "ab", "cd", "GH")

fn: reverse ((poz, poz ...))

Zwraca odwrócić kolejność określonych elementów.

Przykłady: do tyłu (( "AB", "cd", "ef"))

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

Przykłady: do tyłu (( "ab"))

Wyniki :( "ab")

fn: podciąg ((poz, poz ...), start, len)

Zwraca parametr start określa lokalizację projektu powrotu długość sekwencji, sekwencji określonej przez parametr len. Położenie pierwszego projektu to 1.

Przykłady: podciąg (($ item1, $ ITEM2, $ ITEM3, ...), 3)

Wyniki: ($ ITEM3, ...)

Przykłady: podciąg (($ item1, $ ITEM2, $ ITEM3, ...), 2, 2)

Wyniki: ($ ITEM2, $ ITEM3)

fn: nieuporządkowana ((poz, poz ...)) Zgodnie z postanowieniem decyzji wykonawczych, aby powrócić do projektu.

Pojemność Funkcja sekwencja testu

nazwa wyjaśnienie
fn: zero lub jeden (pozycja, poz ...) Jeśli parametr zawiera zero lub jeden przedmiot, a następnie powrót parametrów, w przeciwnym razie zostanie wygenerowany błąd.
fn: jedno-lub-więcej (poz, poz ...) Jeśli parametr zawiera jeden lub więcej elementów, a następnie powrót parametrów, w przeciwnym razie zostanie wygenerowany błąd.
fn: dokładnie jeden (pozycja, poz ...) Jeśli parametr zawiera element, a następnie powrót parametrów, w przeciwnym razie zostanie wygenerowany błąd.

Równa, Union, z wyjątkiem skrzyżowania

nazwa wyjaśnienie
fn: głęboko równe (param1, param2, zestawień) Jeśli param1 i param2 i równi ze sobą (głęboko równe), zwraca wartość true, w przeciwnym razie zwraca false.

funkcja Aggregate

nazwa wyjaśnienie
fn: Ilość ((poz, poz ...)) Zwraca liczbę węzłów.
fn: Średnia ((Arg, Arg, ...)) Średnie wartości parametrów zamian. Przykłady: Średnia ((1,2,3)) Wynik: 2
fn max ((Arg, Arg, ...)) Zwraca parametr jest większa niż w innych parametrów. Przykłady: max ((1,2,3)) Wyniki: Przykłady 3: max (( 'a', 'k')) Wyniki: 'k'
fn: min ((Arg, Arg, ...)) Powrót mniejsza niż innych parametrów parametrów. Przykłady: min ((1,2,3)) Wyniki: Przykłady 1: min (( 'a', 'k')) Rezultaty: 'a'
fn: sum (Arg, Arg, ...) Zwraca określony węzeł ustawić wartość sumy każdego węzła.

Funkcja generowania Sequence

nazwa wyjaśnienie
fn: id ((string, string, ...), węzeł) Zwraca sekwencji węzłów elementów, które mają wartość identyfikatora równą wartości jednej lub więcej wartości określonej w argumencie
fn: IDREF ((string, string, ...), węzeł) Zwraca ciąg element lub atrybut węzłów, które mają wartość IDREF równą wartości jednej lub więcej wartości podanej w argumencie
fn: doc (URI)
fn: doc-available (URI) Jeśli funkcja doc () zwraca węzeł dokumentu, to zwraca wartość true, w przeciwnym razie zwraca false.
  • fn: Kolekcja ()
  • fn: Kolekcja (string)

funkcje kontekstowe

nazwa wyjaśnienie
fn: position ()

Zwraca pozycję indeksu węzła przetwarzane.

Przykłady: // książka [position () <= 3]

Wyniki: Wybierz trzy pierwsze elementy książki

fn: last ()

Zwraca liczbę elementów w liście węzłów przetwarzane.

Przykłady: // książka [ostatni ()]

Wyniki: Wybierz ostatni element książki

fn: prąd dateTime () Zwraca aktualny dateTime (ze strefy czasowej).
fn: current-data () Zwraca bieżącą datę (ze strefy czasowej).
fn: current-time () Zwraca aktualny czas (ze strefy czasowej).
fn: niejawna-czasowa () Wartość zwracana niejawna strefa czasowa.
fn: default-sortowania () Kontrola powraca do wartości domyślnej.
fn: static-base-uri () Wartością zwracaną bazy-uri.