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

النتيجة: 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 ','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 إلى نهاية النص. إذا لم يتم تمرير معرفة 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'

تحويل نص parameter إلى صغير.

مثال: 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 بدون منطقة زمنية.

إذا كان معامل timezone فارغًا، فإنه يعود بـ dateTime يحتوي على منطقة زمنية.

إذا كان معامل timezone فارغًا، فإنه يعود بـ dateTime بدون منطقة زمنية.

إذا كان معامل timezone فارغًا، فإنه يعود بـ date يحتوي على منطقة زمنية.

إذا كان معامل timezone فارغًا، فإنه يعود بوقت بدون منطقة زمنية.

إلا إذا كان يحتوي على time مع الوقت الزمني.

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

يُرجع الموقع في سلسلة العناصر المتطابقة مع معرف 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، مع إدراج قيمة inserts في موقع 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 الأخير