Hàm trong XPath, XQuery và XSLT

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

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

ví dụ: error(fn:QName('http://example.com/test', 'err:toohigh'), 'Lỗi: Giá quá cao')

kết quả: trả về môi trường xử lý bên ngoài http://example.com/test#toohigh và chuỗi "Lỗi: Giá quá cao".

trả về giá trị số của tham số. Tham số có thể là giá trị boolean, chuỗi hoặc tập hợp node.

ví dụ: number('100')

kết quả: 100

trả về giá trị tuyệt đối của tham số.

ví dụ: abs(3.14)

kết quả: 3.14

ví dụ: abs(-3.14)

kết quả: 3.14

trả về số nguyên nhỏ nhất lớn hơn tham số num.

ví dụ: ceiling(3.14)

Kết quả: 4

Trả về số nguyên lớn nhất không lớn hơn tham số num.

Ví dụ: floor(3.14)

Kết quả: 3

Làm tròn tham số num thành số nguyên gần nhất.

Ví dụ: round(3.14)

Kết quả: 3

Ví dụ: round-half-to-even(0.5)

Kết quả: 0

Ví dụ: round-half-to-even(1.5)

Kết quả: 2

Ví dụ: round-half-to-even(2.5)

Kết quả: 2

Trả về giá trị chuỗi của tham số. Tham số có thể là số, giá trị luận lý hoặc tập hợp nút.

Ví dụ: string(314)

Kết quả: "314"

Trả về chuỗi từ dãy mã điểm.

Ví dụ: codepoints-to-string(84, 104, 233, 114, 232, 115, 101)

Kết quả: 'Thérèse'

Trả về dãy mã điểm từ chuỗi.

Ví dụ: string-to-codepoints("Thérèse")

Kết quả: 84, 104, 233, 114, 232, 115, 101

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

Nếu comp1 nhỏ hơn comp2, thì trả về -1. Nếu comp1 bằng comp2, thì trả về 0. Nếu comp1 lớn hơn comp2, thì trả về 1. (Dựa trên quy tắc so sánh được sử dụng).

Ví dụ: compare('ghi', 'ghi')

Kết quả: 0

Trả về việc ghép chuỗi các ký tự.

Ví dụ: concat('XPath ','là ','FUN!')

Kết quả: 'XPath là FUN!'

Sử dụng tham số sep làm dấu phân隔 để trả về chuỗi kết hợp từ tham số string.

Ví dụ: string-join(('We', 'are', 'having', 'fun!'), ' ')

Kết quả: ' We are having fun! '

Ví dụ: string-join(('We', 'are', 'having', 'fun!'))

Kết quả: 'Wearehavingfun!'

Ví dụ: string-join((), 'sep')

Kết quả: ''

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

Trả về chuỗi con từ vị trí start bắt đầu với độ dài được chỉ định. Vị trí đầu tiên là 1. Nếu bỏ qua tham số len, thì trả về chuỗi con từ vị trí start đến cuối chuỗi.

Ví dụ: substring('Beatles',1,4)

Kết quả: 'Beat'

Ví dụ: substring('Beatles',2)

Kết quả: 'eatles'

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

Trả về độ dài của chuỗi được chỉ định. Nếu không có tham số string, thì trả về độ dài của giá trị chuỗi hiện tại.

Ví dụ: string-length('Beatles')

Kết quả: 7

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

Xóa khoảng trắng ở đầu và cuối của chuỗi được chỉ định, và thay thế tất cả các chuỗi khoảng trắng trong nội bộ bằng một khoảng trắng, sau đó trả về kết quả. Nếu không có tham số string, thì xử lý điểm hiện tại.

Ví dụ: normalize-space(' The　　　XML ')

Kết quả: 'The XML'

Chuyển đổi tham số string thành chữ hoa.

Ví dụ: upper-case('The XML')

Kết quả: 'THE XML'

Chuyển đổi tham số string thành chữ thường.

Ví dụ: lower-case('The XML')

Kết quả: 'the xml'

Thay thế string2 trong string1 bằng string3.

Ví dụ: translate('12:30','30','45')

Kết quả: '12:45'

Ví dụ: translate('12:30','03','54')

Kết quả: '12:45'

Ví dụ: translate('12:30','0123','abcd')

Kết quả: 'bc:da'

Ví dụ: escape-uri("http://example.com/test#car", true())

Kết quả: "http%3A%2F%2Fexample.com%2Ftest#car"

Ví dụ: escape-uri("http://example.com/test#car", false())

Kết quả: "http://example.com/test#car"

Ví dụ: escape-uri ("http://example.com/~bébé", false())

Kết quả: "http://example.com/~b%C3%A9b%C3%A9"

Nếu string1 chứa string2, thì trả về true, ngược lại trả về false.

Ví dụ: contains('XML','XM')

Kết quả: true

Nếu string1 bắt đầu bằng string2, thì trả về true, ngược lại trả về false.

Ví dụ: starts-with('XML','X')

Kết quả: true

Nếu string1 kết thúc bằng string2, thì trả về true, ngược lại trả về false.

Ví dụ: ends-with('XML','X')

Kết quả: false

Trả về chuỗi con của string2 xuất hiện trước string2 trong string1.

Ví dụ: substring-before('12/10','/')

Kết quả: '12'

Trả về chuỗi con của string2 xuất hiện sau string1 trong string1.

Ví dụ: substring-after('12/10','/')

Kết quả: '10'

Nếu tham số string khớp với mẫu đã chỉ định, thì trả về true, ngược lại trả về false.

Ví dụ: matches("Merano", "ran")

Kết quả: true

Thay thế mẫu đã chỉ định bằng tham số replace và trả về kết quả.

Ví dụ: replace("Bella Italia", "l", "*")

Kết quả: 'Be**a Ita*ia'

Ví dụ: replace("Bella Italia", "l", "")

Kết quả: 'Bea Itaia'

Ví dụ: tokenize("XPath is fun", "\s+")

Kết quả: ("XPath", "is", "fun")

Đầu tiên, sử dụng hàm boolean() để chuyển đổi tham số thành một giá trị boolean. Nếu giá trị boolean là false, thì trả về true, ngược lại trả về true.

Ví dụ: not(true())

Kết quả: false

Trả về giá trị boolean là true.

Ví dụ: true()

Kết quả: true

Trả về giá trị boolean là false.

Ví dụ: false()

Kết quả: false

Trả về giá trị số nguyên của phần năm trong giá trị cục bộ của tham số.

Ví dụ: year-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Kết quả: 2005

Trả về giá trị số nguyên của phần tháng trong giá trị cục bộ của tham số.

Ví dụ: month-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Kết quả: 01

Trả về giá trị số nguyên của phần ngày trong giá trị cục bộ của tham số.

Ví dụ: day-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Kết quả: 10

Trả về giá trị số nguyên của phần giờ trong giá trị cục bộ của tham số.

Ví dụ: hours-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Kết quả: 12

Trả về giá trị số nguyên của phần phút trong giá trị cục bộ của tham số.

Ví dụ: minutes-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Kết quả: 30

Trả về giá trị số nguyên của phần giây trong giá trị cục bộ của tham số.

Ví dụ: seconds-from-dateTime(xs:dateTime("2005-01-10T12:30:00-04:10"))

Kết quả: 0

Trả về giá trị số nguyên của năm trong giá trị cục bộ của tham số.

Ví dụ: year-from-date(xs:date("2005-04-23"))

Kết quả: 2005

Trả về giá trị nguyên của phần tháng trong giá trị địa phương của tham số.

Ví dụ: month-from-date(xs:date("2005-04-23"))

Kết quả: 4

Trả về giá trị nguyên của phần ngày trong giá trị địa phương của tham số.

Ví dụ: day-from-date(xs:date("2005-04-23"))

Kết quả: 23

Trả về giá trị nguyên của phần giờ trong giá trị địa phương của tham số.

Ví dụ: hours-from-time(xs:time("10:22:00"))

Kết quả: 10

Trả về giá trị nguyên của phần phút trong giá trị địa phương của tham số.

Ví dụ: minutes-from-time(xs:time("10:22:00"))

Kết quả: 22

Trả về giá trị nguyên của phần giây trong giá trị địa phương của tham số.

Ví dụ: seconds-from-time(xs:time("10:22:00"))

Kết quả: 0

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

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

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

Nếu ngôn ngữ của nút hiện tại khớp với ngôn ngữ được chỉ định, thì trả về true。

Ví dụ: Lang("en") là true cho <p xml:lang="en">...</p>

Ví dụ: Lang("de") là false cho <p xml:lang="en">...</p>

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

Trả về vị trí của phần tử trong chuỗi phần tử bằng với tham số searchitem.

Ví dụ: index-of ((15, 40, 25, 40, 10), 40)

Kết quả: (2, 4)

Ví dụ: index-of (("a", "dog", "and", "a", "duck"), "a")

Kết quả: (1, 4)

Ví dụ: index-of ((15, 40, 25, 40, 10), 18)

Kết quả: ()

Trả về một chuỗi mới được tạo từ tham số item - đồng thời xóa bỏ phần tử tại vị trí được chỉ định bởi tham số position。

Ví dụ: remove(("ab", "cd", "ef"), 0)

Kết quả: ("ab", "cd", "ef")

Ví dụ: remove(("ab", "cd", "ef"), 1)

Kết quả: ("cd", "ef")

Ví dụ: remove(("ab", "cd", "ef"), 4)

Kết quả: ("ab", "cd", "ef")

Nếu giá trị tham số là chuỗi rỗng, thì trả về true, ngược lại trả về false。

Ví dụ: empty(remove(("ab", "cd"), 1))

Kết quả: false

Nếu giá trị của tham số không phải là chuỗi rỗng, thì trả về true, ngược lại trả về false.

Ví dụ: exists(remove(("ab"), 1))

Kết quả: false

Trả về các giá trị duy nhất.

Ví dụ: distinct-values((1, 2, 3, 1, 2))

Kết quả: (1, 2, 3)

Trả về chuỗi mới được tạo từ tham số item, đồng thời chèn giá trị của tham số inserts vào vị trí được chỉ định bởi tham số pos.

Ví dụ: insert-before(("ab", "cd"), 0, "gh")

Kết quả: ("gh", "ab", "cd")

Ví dụ: insert-before(("ab", "cd"), 1, "gh")

Kết quả: ("gh", "ab", "cd")

Ví dụ: insert-before(("ab", "cd"), 2, "gh")

Kết quả: ("ab", "gh", "cd")

Ví dụ: insert-before(("ab", "cd"), 5, "gh")

Kết quả: ("ab", "cd", "gh")

Trả về thứ tự ngược lại của mục được chỉ định.

Ví dụ: reverse(("ab", "cd", "ef"))

Kết quả: ("ef", "cd", "ab")

Ví dụ: reverse(("ab"))

Kết quả: ("ab")

Trả về chuỗi các mục tại vị trí được chỉ định bởi tham số start, độ dài của chuỗi được chỉ định bởi tham số len. Vị trí của mục đầu tiên là 1.

Ví dụ: subsequence(($item1, $item2, $item3,...), 3)

Kết quả: ($item3, ...)

Ví dụ: subsequence(($item1, $item2, $item3, ...), 2, 2)

Kết quả: ($item2, $item3)

Trả về giá trị trung bình của các tham số

Ví dụ: avg((1,2,3))

Kết quả: 2

Trả về tham số lớn hơn các tham số khác

Ví dụ: max((1,2,3))

Kết quả: 3

Ví dụ: max(('a', 'k'))

Kết quả: 'k'

Trả về tham số nhỏ hơn các tham số khác

Ví dụ: min((1,2,3))

Kết quả: 1

Ví dụ: min(('a', 'k'))

Kết quả: 'a'

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

Trả về vị trí index của nút đang được xử lý.

Ví dụ: //book[position()<=3]

Kết quả: Chọn ba phần tử book đầu tiên

Trả về số lượng mục trong danh sách nút đang được xử lý.

Ví dụ: //book[last()]

Kết quả: Chọn phần tử book cuối cùng