توابع XPath، XQuery و XSLT

• 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')

نتیجه: 100

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

مثال: abs(3.14)

نتیجه: 3.14

مثال: abs(-3.14)

نتیجه: 3.14

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

مثال: ceiling(3.14)

نتیجه: 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 ','است ','سرگرم‌کننده!')

نتایج: 'XPath است سرگرم‌کننده!}

از پارامتر 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 با پارامتر مشخص شده‌ی pattern مطابقت داشته باشد، 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

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

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

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

اگر زبان فعلی نقطه‌ی فعلی با زبان مشخص شده تطابق داشته باشد، true برمی‌گرداند.

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

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

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

مقدار position را در توالی پروژه‌ای که با searchitem برابر است، برمی‌گرداند.

مثال: 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 بازسازی می‌شود - در حالی که پروژه‌ای که در 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)

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

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

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

تعداد عناصر در لیست در حال پردازش را بازگرداند.

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

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