وظائف 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

يعود بجمع النصوص.

مثال: concatenate('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'

استبدل نص2 في نص1 بالنص3.

مثال: 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"

إذا كان نص1 يحتوي على نص2، فإنه يعود true، وإلا يعود false.

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

النتيجة: true

إذا كان نص1 يبدأ بالنص2، فإنه يعود true، وإلا يعود false.

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

النتيجة: true

إذا كان نص1 ينتهي بالنص2، فإنه يعود true، وإلا يعود false.

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

النتيجة: false

يعود النص الموجود قبل ظهور نص2 في نص1.

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

النتيجة: '12'

يعود النص الموجود بعد ظهور نص2 في نص1.

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

النتيجة: '10'

إذا كانت قيمة النص متطابقة مع النمط المحدد، يُرجع صحيحة، وإلا يُرجع غير صحيحة.

مثال: 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() المعامل إلى قيمة بولية. إذا كانت القيمة البولية غير صحيحة، يُرجع صحيحة، وإلا يُرجع صحيحة.

مثال: not(true())

النتيجة: false

يُرجع قيمة بولية صحيحة.

مثال: true()

النتيجة: true

يُرجع قيمة بولية غير صحيحة.

مثال: 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)

إذا كان لغة النقطة الحالية تتطابق مع اللغة المحددة، فإنه يعود صحيح.

مثال: Lang("en") هو صحيح لل <p xml:lang="en">...</p>

مثال: Lang("de") هو خطأ لل <p xml:lang="en">...</p>

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

يعود المواضع في سلسلة العناصر التي تساوي مع معامل 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")

إذا كان قيمة المعامل فارغة، فإنه يعود صحيح، وإلا يعود خطأ.

مثال: 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

مثال: 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