توابع XSLT، XPath و XQuery

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

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

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

نتیجه: به محیط پردازش خارجی http://example.com/test#toohigh و رشته "Error: Price is too high" بازمی‌گردانده شود.

مقدار بازگردانده شده. پارامتر می‌تواند مقدار بولین، رشته یا مجموعه‌ای از نودها باشد.

例子：number('100')

مثال: number('100')

fn:abs(num)

مقدار绝对 را بازگردانید.

مثال: abs(-3.14)

مثال: abs(3.14)

مثال: abs(-3.14)

fn:ceiling(num)

مقدار کوچکترین عدد صحیح که از num بزرگتر باشد را بازگردانید.

نتیجه: 4

بزرگترین عدد صحیح که از num کمتر یا برابر با آن باشد را بازگردانید.

مثال: floor(3.14)

نتیجه: 3

پارامتر num را به نزدیک‌ترین عدد صحیح نزدیک می‌کند.

مثال: round(3.14)

نتیجه: 3

مثال: round-half-to-even(0.5)

نتیجه: 0

مثال: round-half-to-even(1.5)

نتیجه: 2

مثال: round-half-to-even(2.5)

نتیجه: 2

مقدار رشته‌ای پارامتر را بازگردانید. پارامتر می‌تواند عدد، ارزش منطقی یا مجموعه نود باشد.

مثال: string(314)

نتیجه: "314"

بر اساس توالی کد نقطه، رشته را بازگردانید.

مثال: codepoints-to-string(84, 104, 233, 114, 232, 115, 101)

نتیجه: 'Thérèse'

بر اساس رشته، توالی کد نقطه را بازگردانید.

مثال: string-to-codepoints("Thérèse")

نتیجه: 84, 104, 233, 114, 232, 115, 101

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

اگر comp1 کمتر از comp2 باشد، -1 را بازگردانید. اگر comp1 برابر با comp2 باشد، 0 را بازگردانید. اگر comp1 بزرگتر از comp2 باشد، 1 را بازگردانید. (بر اساس قوانین تطبیق استفاده شده).

مثال: compare('ghi', 'ghi')

نتیجه: 0

بازگشت ترکیب رشته‌ها.

مثال: concat('XPath ','is ','FUN!')

نتیجه: 'XPath is FUN!'

استفاده از پارامتر sep به عنوان جداکننده برای بازگشت رشته‌ای که از پارامترهای string ترکیب شده.

مثال: string-join(('We', 'are', 'having', 'fun!'), ' ')

نتیجه: ' We are having fun! '

مثال: string-join(('We', 'are', 'having', 'fun!'))

نتیجه: 'Wearehavingfun!'

مثال: string-join((), 'sep')

نتیجه: ''

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

بازگشت رشته معین از موقعیت start به طول معین. اولین کاراکتر شمارنده 1 است. اگر پارامتر len را حذف کنید، رشته از موقعیت start تا انتهای رشته بازمی‌گرداند.

مثال: substring('Beatles',1,4)

نتیجه: 'Beat'

مثال: substring('Beatles',2)

نتیجه: 'eatles'

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

بازگشت طول رشته معین. اگر پارامتر string وجود نداشته باشد، طول رشته ارزش فعلی گره را بازمی‌گرداند.

مثال: string-length('Beatles')

نتیجه: 7

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

حذف فضاهای خالی در ابتدا و انتهای رشته معین و جایگزینی تمام توالی‌های فضاهای خالی درونی با یک فضا و بازگشت نتایج. اگر پارامتر string وجود نداشته باشد، به فضای خالی فعلی عمل می‌کند.

مثال: normalize-space(' The　　　XML ')

نتیجه: 'The XML'

تغییر پارامتر string به حروف بزرگ.

مثال: upper-case('The XML')

نتیجه: 'THE XML'

string را به صورت کوچک تبدیل می‌کند.

مثال: lower-case('The XML')

نتیجه: 'the xml'

string2 را در string1 جایگزین string3 می‌کند.

مثال: translate('12:30','30','45')

نتیجه: '12:45'

مثال: translate('12:30','03','54')

نتیجه: '12:45'

مثال: translate('12:30','0123','abcd')

نتیجه: 'bc:da'

مثال: escape-uri("http://example.com/test#car", true())

نتیجه: "http%3A%2F%2Fexample.com%2Ftest#car"

مثال: escape-uri("http://example.com/test#car", false())

نتیجه: "http://example.com/test#car"

مثال: escape-uri ("http://example.com/~bébé", false())

نتیجه: "http://example.com/~b%C3%A9b%C3%A9"

اگر string1 شامل string2 است، true را بازمی‌گرداند، در غیر این صورت false را بازمی‌گرداند.

مثال: contains('XML','XM')

نتیجه: true

اگر string1 با string2 آغاز می‌شود، true را بازمی‌گرداند، در غیر این صورت false را بازمی‌گرداند.

مثال: starts-with('XML','X')

نتیجه: true

اگر string1 با string2 پایان می‌یابد، true را بازمی‌گرداند، در غیر این صورت false را بازمی‌گرداند.

مثال: ends-with('XML','X')

نتیجه: false

بازگشت به زیرشاخه‌ای که string2 در string1 وجود دارد.

مثال: substring-before('12/10','/')

نتیجه: '12'

بازگشت زیر رشته string2 در string1 پس از ظهور.

مثال: substring-after('12/10','/')

نتیجه: '10'

اگر پارامتر string با مدل مشخص شده مطابقت داشته باشد، true بازمی‌گرداند، در غیر این صورت false بازمی‌گرداند.

مثال: matches("Merano", "ran")

نتیجه: true

جایگزینی مدلی مشخص شده به جای پارامتر replace و بازگشت نتیجه.

مثال: replace("Bella Italia", "l", "*")

نتیجه: 'Be**a Ita*ia'

مثال: replace("Bella Italia", "l", "")

نتیجه: 'Bea Itaia'

مثال: tokenize("XPath is fun", "\s+")

نتیجه: ("XPath", "is", "fun")

ابتدا با استفاده از توابع boolean() پارامتر به یک مقدار بولن تبدیل می‌شود.

اگر مقدار بولن false باشد، true بازمی‌گرداند، در غیر این صورت true بازمی‌گرداند.

مثال: not(true())

نتیجه: false

بازگشت مقدار بولن true.

مثال: true()

نتیجه: true

بازگشت مقدار بولن false.

مثال: false()

نتیجه: false

بازگشتی از پارامتر محلی به صورت عدد صحیح.

مثال: year-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

نتیجه: 2005

بازگشتی از پارامتر محلی به صورت عدد صحیح.

مثال: month-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

نتیجه: 01

بازگشتی از پارامتر محلی به صورت عدد صحیح.

مثال: day-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

نتیجه: 10

بازگشتی از پارامتر محلی به صورت عدد صحیح.

مثال: hours-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

نتیجه: 12

بازگشتی از پارامتر محلی به صورت عدد صحیح.

مثال: minutes-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

نتیجه: 30

بازگشتی از پارامتر محلی به صورت عدد دودویی.

مثال: seconds-from-dateTime(xs:dateTime("2005-01-10T12:30:00-04:10"))

نتیجه: 0

بخش عددی سال پارامتر محلی را برمی‌گرداند.

مثال: year-from-date(xs:date("2005-04-23"))

نتیجه: 2005

بخش عددی ماه پارامتر محلی را برمی‌گرداند.

مثال: month-from-date(xs:date("2005-04-23"))

نتیجه: 4

بخش عددی روز پارامتر محلی را برمی‌گرداند.

مثال: day-from-date(xs:date("2005-04-23"))

نتیجه: 23

بخش عددی ساعتی پارامتر محلی را برمی‌گرداند.

مثال: hours-from-time(xs:time("10:22:00"))

نتیجه: 10

بخش عددی دقیقه‌ای پارامتر محلی را برمی‌گرداند.

مثال: minutes-from-time(xs:time("10:22:00"))

نتیجه: 22

بخش عددی ثانیه‌ای پارامتر محلی را برمی‌گرداند.

مثال: seconds-from-time(xs:time("10:22:00"))

نتیجه: 0

اگر پارامتر timezone خالی باشد، dateTime بدون منطقه زمانی را برمی‌گرداند.

در غیر این صورت، dateTime با منطقه زمانی را برمی‌گرداند.

اگر پارامتر timezone خالی باشد، date بدون منطقه زمانی را برمی‌گرداند.

در غیر این صورت، date با منطقه زمانی را برمی‌گرداند.

اگر پارامتر timezone خالی باشد، time بدون منطقه زمانی را برمی‌گرداند.

در غیر این صورت بازگرداندن زمان با منطقه زمانی.

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

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

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

اگر زبان پروژه node با زبان مشخص شده مطابقت دارد، به true بازمی‌گردد.

مثال: Lang("en") برای <p xml:lang="en">...</p>

مثال: Lang("de") برای <p xml:lang="en">...</p>

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

بازگرداندن موقعیت پروژه searchitem در توالی پروژه item.

مثال: index-of ((15, 40, 25, 40, 10), 40)

نتیجه: (2, 4)

مثال: index-of (("a", "dog", "and", "a", "duck"), "a")

نتیجه (1, 4)

مثال: index-of ((15, 40, 25, 40, 10), 18)

نتیجه: ()

بازگرداندن یک توالی جدید از item با استفاده از پارامتر item - در حالی که به پروژه position اشاره می‌کند.

مثال: remove(("ab", "cd", "ef"), 0)

نتیجه: ("ab", "cd", "ef")

مثال: remove(("ab", "cd", "ef"), 1)

نتیجه: ("cd", "ef")

مثال: remove(("ab", "cd", "ef"), 4)

نتیجه: ("ab", "cd", "ef")

اگر مقادیر پارامترها توالی خالی هستند، در این صورت true برگشت می‌دهند، در غیر این صورت false.

مثال: empty(remove(("ab", "cd"), 1))

نتیجه: false

اگر مقادیر پارامترها توالی خالی نیستند، در این صورت true برگشت می‌دهند، در غیر این صورت false.

مثال: exists(remove(("ab"), 1))

نتیجه: false

برگشت به مجموعه‌ای از مقادیر متفاوت.

مثال: distinct-values((1, 2, 3, 1, 2))

نتیجه: (1, 2, 3)

برگشت به توالی جدیدی که توسط پارامتر item تعریف شده و در موقعیت مشخص شده توسط پارامتر pos، مقدار inserts اضافه شده است.

مثال: insert-before(("ab", "cd"), 0, "gh")

نتیجه: ("gh", "ab", "cd")

مثال: insert-before(("ab", "cd"), 1, "gh")

نتیجه: ("gh", "ab", "cd")

مثال: insert-before(("ab", "cd"), 2, "gh")

نتیجه: ("ab", "gh", "cd")

مثال: insert-before(("ab", "cd"), 5, "gh")

نتیجه: ("ab", "cd", "gh")

برگشت به ترتیب معکوس از پروژه‌های مشخص شده.

مثال: reverse(("ab", "cd", "ef"))

نتیجه: ("ef", "cd", "ab")

مثال: reverse(("ab"))

نتیجه: ("ab")

برگشت به موقعیت تعیین شده توسط پارامتر start و طول تعیین شده توسط پارامتر len از توالی اعضا.

موقع اولین پروژه 1 است.

مثال: subsequence(($item1, $item2, $item3,...), 3)

نتیجه: ($item3, ...)

مثال: subsequence(($item1, $item2, $item3, ...), 2, 2)

نتیجه: ($item2, $item3)

بازگشت میانگین مقادیر پارامترها.

مثال: avg((1,2,3))

نتیجه: 2

بازگشت پارامتری که بیشتر از سایر پارامترها است.

مثال: max((1,2,3))

نتیجه: 3

مثال: max(('a', 'k'))

نتیجه: 'k'

بازگشت پارامتری که کمتر از سایر پارامترها است.

مثال: min((1,2,3))

نتیجه: 1

مثال: min(('a', 'k'))

نتیجه: 'a'

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

موقعیت گره فعلی را بازگردانید که در حال پردازش است.

مثال: //book[position()<=3]

نتیجه: انتخاب سه عنصر اول book

تعداد موارد در لیست گره‌هایی که در حال پردازش هستند را بازگردانید.

مثال: //book[last()]

نتیجه: انتخاب آخرین عنصر book