XSLT 2.0، 2.0 كسباث وكسكيري 1.0، يشتركون في نفس مكتبة الوظائف.

وظائف المرجعي

استرجاع
خطأ وتعقبها
رقمية
خيط

AnyURI
منطقية
المدة / تاريخ / وقت
QName

العقدة
تسلسل
سياق الكلام

البادئة الافتراضي لمساحة الاسم الوظيفة FN:
وURI من مساحة الاسم وظيفة هو: http://www.w3.org/2005/xpath-functions

Tip: غالبا ما تسمى وظائف مع الجبهة الوطنية: البادئة، مثل الجبهة الوطنية: string() . ومع ذلك، منذ FN: هو بادئة الافتراضي مساحة الاسم، لا تحتاج إلى أسماء وظيفة لتكون مسبوقة عندما دعا.

وظائف استرجاع

اسم	وصف
fn:node- name( node )	إرجاع اسم عقدة عقدة حجة
fn: nilled( node )	بإرجاع قيمة منطقية تشير إلى ما إذا كان nilled العقدة حجة
fn: data( item.item,... )	يأخذ سلسلة من البنود وإرجاع سلسلة من القيم الذرية
fn:base- uri() fn:base- uri( node )	إرجاع قيمة العقار قاعدة أوري العقدة الحالية أو محدد
fn:document- 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') ، 'خطأ: السعر مرتفع جدا') النتيجة: عودة http://example.com/test#toohigh وسلسلة "Error: Price is too high" للبيئة المعالجة الخارجية
fn: trace( value,label )	تستخدم على الاستفسارات التصحيح

وظائف على القيم الرقمية

اسم	وصف
fn: number( arg )	إرجاع قيمة رقمية من ذي الحجة. حجة يمكن أن تكون منطقية، سلسلة، أو عقدة مجموعة مثال: number('100') النتيجة: 100
fn: abs( num )	إرجاع القيمة المطلقة من ذي الحجة مثال: abs(3.14) النتيجة: 3.14 مثال: abs(-3.14) النتيجة: 3.14
fn: ceiling( num )	إرجاع أصغر عدد صحيح أكبر من حجة رقم على سبيل المثال: ceiling(3.14) النتيجة: 4
fn: floor( num )	إرجاع أكبر عدد صحيح ليس أكبر من حجة رقم مثال: floor(3.14) النتيجة: 3
fn: round( num )	تقريب حجة العدد إلى أقرب عدد صحيح على سبيل المثال: round(3.14) النتيجة: 3
fn:round-half-to- even()	مثال: على مدار نصف الاستحقاق even(0.5) النتيجة: 0 مثال: على مدار نصف الاستحقاق even(1.5) النتيجة: 2 مثال: على مدار نصف الاستحقاق even(2.5) النتيجة: 2

وظائف في سلاسل

اسم	وصف
fn: string( arg )	إرجاع قيمة سلسلة من ذي الحجة. حجة يمكن أن يكون العدد، منطقية، أو عقدة مجموعة على سبيل المثال: string(314) النتيجة: "314"
fn:codepoints-to- string(( int,int,... ) )	يخلق سلسلة من سلسلة من النقاط رمز Unicode القياسية على سبيل المثال: codepoints-الاستحقاق string((84, 104, 233, 114, 232, 115, 101) ) النتيجة: "تيريز"
fn:string-to- codepoints( string )	إرجاع سلسلة من النقاط كود القياسية يونيكود من سلسلة على سبيل المثال: سلسلة الاستحقاق codepoints("Th r se") النتيجة: (84, 104, 233, 114, 232, 115, 101)
fn:codepoint- equal( comp1,comp2 )	عرض true إذا كانت قيمة comp1 تساوي قيمة comp2، وفقا ليونيكود كود جمع نقطة (http://www.w3.org/2005/02/xpath-functions/collation/codepoint) ، وإلا فإنها ترجع كاذبة
fn: compare( comp1,comp2 ) fn: compare( comp1,comp2,collation )	يعود -1 إذا comp1 أقل من comp2، 0 إذا comp1 يساوي comp2، أو 1 إذا comp1 أكبر من comp2 (وفقا لقواعد الترتيب الذي يتم استخدامه) مثال: compare('ghi', 'ghi') النتيجة: 0
fn: concat( string,string,... )	إرجاع سلسلة من السلاسل على سبيل المثال: concat('XPath ','is ','FUN!') النتيجة: "كسباث هو FUN!
fn:string- join( (string,string,...) ,sep)	بإرجاع سلسلة إنشاؤها بواسطة وصل الحجج سلسلة واستخدام حجة سبتمبر كفاصل على سبيل المثال: STRING- join(('We', 'are', 'having', 'fun!') ، '') النتيجة: "نحن يلهون! ' على سبيل المثال: STRING- join(('We', 'are', 'having', 'fun!') ) النتيجة: "Wearehavingfun! على سبيل المثال: STRING- join(() ، 'سبتمبر') نتيجة: ''
fn: substring( string,start,len ) fn: substring( string,start )	إرجاع فرعية من موقع بداية لمدة محددة. فهرس الحرف الأول هو 1. إذا تم حذف طول تقوم بإرجاع سلسلة فرعية من موقع البداية وحتى النهاية على سبيل المثال: substring('Beatles',1,4) النتيجة: 'الفوز' على سبيل المثال: substring('Beatles',2) النتيجة: "eatles"
fn:string- length( string ) fn:string- length()	إرجاع طول السلسلة المحددة. إذا لم يكن هناك حجة سلسلة تقوم بإرجاع طول سلسلة القيمة من العقدة الحالية على سبيل المثال: STRING- length('Beatles') النتيجة: 7
fn:normalize- space( string ) fn:normalize- space()	يزيل الرائدة ومسافات زائدة من السلسلة المحددة، ويحل محل كل متواليات الداخلية من المساحة البيضاء مع واحد وإرجاع النتيجة. إذا لم يكن هناك حجة سلسلة أنه يفعل نفس الشيء على العقدة الحالية على سبيل المثال: normalize- space(' The XML ') النتيجة: "إن XML"
fn:normalize- unicode()
fn:upper- case( string )	تحويل سيطة سلسلة الأحرف الكبيرة على سبيل المثال: العلوية case('The XML') النتيجة: 'THE XML "
fn:lower- case( string )	تحويل سيطة سلسلة لانخفاض حدة على سبيل المثال: ذات الدخول المتدنية case('The XML') النتيجة: "في أكس"
fn: translate( string1,string2,string3 )	تحويل STRING1 عن طريق استبدال الأحرف في STRING2 مع شخصيات في string3 على سبيل المثال: translate('12:30','30','45') النتيجة: '12: 45 ' على سبيل المثال: translate('12:30','03','54') النتيجة: '12: 45 ' على سبيل المثال: translate('12:30','0123','abcd') النتيجة: "قبل الميلاد: دا"
fn:escape- uri( stringURI,esc-res )	على سبيل المثال: 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" على سبيل المثال: الهروب اوري ("http://example.com/~b b ", false() ) النتيجة: "http://example.com/~b%C3%A9b%C3%A9"
fn: contains( string1,string2 )	عرض true إذا كانت STRING1 يحتوي STRING2، وإلا فإنها ترجع كاذبة مثال: contains('XML','XM') النتيجة: صحيح
fn:starts- with( string1,string2 )	يعود صحيحا إذا يبدأ STRING1 مع STRING2، وإلا فإنها ترجع كاذبة على سبيل المثال: starts- with('XML','X') النتيجة: صحيح
fn:ends- with( string1,string2 )	يعود صحيحا إذا ينتهي STRING1 مع STRING2، وإلا فإنها ترجع كاذبة مثال: انتهى- with('XML','X') النتيجة: كاذبة
fn:substring- before( string1,string2 )	ترجع بداية STRING1 قبل حدوث STRING2 فيه على سبيل المثال: substring- before('12/10','/') النتيجة: '12'
fn:substring- after( string1,string2 )	إرجاع ما تبقى من STRING1 بعد حدوث STRING2 فيه على سبيل المثال: substring- after('12/10','/') النتيجة: '10'
fn: matches( string,pattern )	عرض true إذا كانت الوسيطة سلسلة مباريات النمط، وإلا فإنها ترجع كاذبة على سبيل المثال: matches("Merano", "ran") النتيجة: صحيح
fn: replace( string,pattern,replace )	بإرجاع سلسلة التي تم إنشاؤها عن طريق استبدال نمط معين مع استبدال حجة على سبيل المثال: replace("Bella Italia", "l" , "") النتيجة: "كن * في ايطاليا * الجيش العراقي" مثال: replace("Bella Italia", "l" , "") النتيجة: "بيا Itaia"
fn: tokenize( string,pattern )	على سبيل المثال: tokenize("XPath is fun", "\s+") النتيجة: ("XPath", "is" , "fun")

وظائف لanyURI

اسم	وصف
fn:resolve- uri( relative,base )

وظائف على القيم المنطقية

اسم	وصف
fn: boolean( arg )	بإرجاع قيمة منطقية لعدد، سلسلة، أو عقدة مجموعة
fn: not( arg )	يتم تقليل حجة أول من قيمة منطقية من خلال تطبيق boolean() وظيفة. إرجاع TRUE إذا كانت القيمة المنطقية خاطئة، وكاذبة إذا كانت قيمة منطقية صحيحة على سبيل المثال: not(true() ) النتيجة: كاذبة
fn: true()	إرجاع قيمة منطقية صحيح على سبيل المثال: true() النتيجة: صحيح
fn: false()	إرجاع قيمة منطقية كاذبة على سبيل المثال: false() النتيجة: كاذبة

وظائف في الآماد، التواريخ والأوقات

وظائف استخراج المكونات على الآماد، التواريخ والأوقات

اسم	وصف
fn: dateTime( date,time )	تحويل الحجج لتاريخ ووقت
fn:years-from- duration( datetimedur )	بإرجاع عدد صحيح يمثل العنصر سنوات في تمثيل المفردات الكنسي من قيمة الوسيطة
fn:months-from- duration( datetimedur )	بإرجاع عدد صحيح يمثل عنصر أشهر في تمثيل المفردات الكنسي من قيمة الوسيطة
fn:days-from- duration( datetimedur )	بإرجاع عدد صحيح يمثل عنصر أيام في تمثيل المفردات الكنسي من قيمة الوسيطة
fn:hours-from- duration( datetimedur )	بإرجاع عدد صحيح يمثل عنصر ساعات في تمثيل المفردات الكنسي من قيمة الوسيطة
fn:minutes-from- duration( datetimedur )	بإرجاع عدد صحيح يمثل عنصر دقيقة في تمثيل المفردات الكنسي من قيمة الوسيطة
fn:seconds-from- duration( datetimedur )	يعود عشري الذي يمثل المكون ثانية في تمثيل المفردات الكنسي من قيمة الوسيطة
fn:year-from- dateTime( datetime )	بإرجاع عدد صحيح يمثل عنصر عام في قيمة مترجم من حجة مثال: سنة from- dateTime(xs:dateTime("2005-01-10T12:30-04:10") ) النتيجة: 2005
fn:month-from- dateTime( datetime )	بإرجاع عدد صحيح يمثل العنصر الشهر في قيمة مترجم من حجة على سبيل المثال: في شهر from- dateTime(xs:dateTime("2005-01-10T12:30-04:10") ) النتيجة: 01
fn:day-from- dateTime( datetime )	بإرجاع عدد صحيح يمثل عنصر اليوم في قيمة مترجم من حجة على سبيل المثال: يوم from- dateTime(xs:dateTime("2005-01-10T12:30-04:10") ) النتيجة: 10
fn:hours-from- dateTime( datetime )	بإرجاع عدد صحيح يمثل عنصر ساعات في قيمة مترجم من حجة على سبيل المثال: ساعة from- dateTime(xs:dateTime("2005-01-10T12:30-04:10") ) النتيجة: 12
fn:minutes-from- dateTime( datetime )	بإرجاع عدد صحيح يمثل عنصر دقيقة في قيمة مترجم من حجة على سبيل المثال: دقيقة-from- dateTime(xs:dateTime("2005-01-10T12:30-04:10") ) النتيجة: 30
fn:seconds-from- dateTime( datetime )	يعود عشري الذي يمثل المكون ثانية في قيمة مترجم من حجة على سبيل المثال: ثوان from- dateTime(xs:dateTime("2005-01-10T12:30:00-04:10") ) النتيجة: 0
fn:timezone-from- dateTime( datetime )	إرجاع عنصر المنطقة الزمنية من ذي الحجة إن وجدت
fn:year-from- date( date )	بإرجاع عدد صحيح يمثل السنة في قيمة مترجم من حجة مثال: سنة from- date(xs:date("2005-04-23") ) النتيجة: 2005
fn:month-from- date( date )	بإرجاع عدد صحيح يمثل شهر في قيمة مترجم من حجة على سبيل المثال: في شهر from- date(xs:date("2005-04-23") ) النتيجة: 4
fn:day-from- date( date )	بإرجاع عدد صحيح يمثل اليوم في قيمة مترجم من حجة على سبيل المثال: يوما from- date(xs:date("2005-04-23") ) النتيجة: 23
fn:timezone-from- date( date )	إرجاع عنصر المنطقة الزمنية من ذي الحجة إن وجدت
fn:hours-from- time( time )	بإرجاع عدد صحيح يمثل عنصر ساعات في قيمة مترجم من حجة على سبيل المثال: ساعة from- time(xs:time("10:22:00") ) النتيجة: 10
fn:minutes-from- time( time )	بإرجاع عدد صحيح يمثل عنصر دقيقة في قيمة مترجم من حجة على سبيل المثال: دقيقة-from- time(xs:time("10:22:00") ) النتيجة: 22
fn:seconds-from- time( time )	بإرجاع عدد صحيح يمثل عنصر ثانية في قيمة مترجم من حجة على سبيل المثال: ثوان from- time(xs:time("10:22:00") ) النتيجة: 0
fn:timezone-from- time( time )	إرجاع عنصر المنطقة الزمنية من ذي الحجة إن وجدت
fn:adjust-dateTime-to- timezone( datetime,timezone )	إذا كانت الوسيطة التوقيت فارغة، فإنها ترجع إلى التاريخ والوقت دون منطقة زمنية. وإلا، فإنه إرجاع التاريخ والوقت مع التوقيت
fn:adjust-date-to- timezone( date ,timezone )	إذا كانت الوسيطة التوقيت فارغة، فإنه يعود تاريخ بدون توقيت. خلاف ذلك، فإنها ترجع موعد مع التوقيت
fn:adjust-time-to- timezone( time ,timezone )	إذا كانت الوسيطة التوقيت فارغة، فإنها ترجع وقت دون توقيت. خلاف ذلك، فإنها ترجع وقت مع التوقيت

وظائف ذات صلة إلى QNames

اسم	وصف
fn: QName()
fn:local-name-from- QName()
fn:namespace-uri-from- QName()
fn:namespace-uri-for- prefix()
fn:in-scope- prefixes()
fn:resolve- QName()

وظائف في العقد

اسم	وصف
fn: name() fn: name( nodeset )	يعود اسم العقدة الحالية أو العقدة الأولى في مجموعة العقدة المحددة
fn:local- name() fn:local- name( nodeset )	إرجاع اسم العقدة الحالية أو العقدة الأولى في مجموعة العقدة المحددة - من دون بادئة مساحة الاسم
fn:namespace- uri() fn:namespace- uri( nodeset )	إرجاع مساحة اسم URI من العقدة الحالية أو العقدة الأولى في مجموعة العقدة المحددة
fn: lang( lang )	عرض true إذا كانت لغة العقدة الحالية مباريات لغة اللغة المحددة على سبيل المثال: Lang("en") هو الصحيح ل <P أكس: لانج = "أون"> ... </ P> على سبيل المثال: Lang("de") غير صحيح ل <P أكس: لانج = "أون"> ... </ P>
fn: root() fn: root( node )	ترجع جذور الشجرة التي العقدة الحالية أو المحدد ينتمي. وسوف يكون هذا عادة عقدة ثيقة

وظائف في متواليات

وظائف عامة عن متواليات

اسم	وصف
fn:index- of( (item,item,...) ,searchitem)	يعود المواقف داخل سلسلة من البنود التي تساوي حجة searchitem مثال: مؤشر من ((15, 40, 25, 40, 10) ، 40) النتيجة: (2, 4) مثال: مؤشر ل (("a", "dog" , "and" , "a" , "duck") ، "أ") نتيجة (1, 4) مثال: مؤشر من ((15, 40, 25, 40, 10) ، 18) النتيجة: ()
fn: remove( (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")
fn: empty( item,item,... )	عرض true إذا كانت قيمة الحجج هو تسلسل فارغة، وإلا فإنها ترجع كاذبة مثال: empty(remove(("ab", "cd") ، 1)) النتيجة: كاذبة
fn: exists( item,item,... )	عرض true إذا كانت قيمة الحجج ليست تسلسل فارغة، وإلا فإنها ترجع كاذبة على سبيل المثال: exists(remove(("ab") ، 1)) النتيجة: كاذبة
fn:distinct- values( (item,item,...) ,collation)	يعود فقط متميزة (different) القيم على سبيل المثال: distinct- values((1, 2, 3, 1, 2) ) النتيجة: (1, 2, 3)
fn:insert- before( (item,item,...) ,pos,inserts)	بإرجاع سلسلة جديدة شيدت من قيمة الحجج البند - مع قيمة الوسيطة إدراج إدراجها في الموضع المحدد بواسطة حجة نقاط البيع على سبيل المثال: insert- before(("ab", "cd") ، 0، "غ") النتيجة: ("gh", "ab" , "cd") على سبيل المثال: insert- before(("ab", "cd") ، 1، "غ") النتيجة: ("gh", "ab" , "cd") على سبيل المثال: insert- before(("ab", "cd") ، 2، "غ") النتيجة: ("ab", "gh" , "cd") على سبيل المثال: insert- before(("ab", "cd") ، 5، "غ") النتيجة: ("ab", "cd" , "gh")
fn: reverse( (item,item,...) )	يعود الأمر عكس من البنود المحددة على سبيل المثال: reverse(("ab", "cd" , "ef") ) النتيجة: ("ef", "cd" , "ab") على سبيل المثال: reverse(("ab") ) النتيجة: ("ab")
fn: subsequence( (item,item,...) ,start,len)	بإرجاع سلسلة من العناصر من الموضع المحدد بواسطة حجة بداية واستمرار لعدد من البنود المحددة من قبل حجة ليون. ويقع هذا البند الأول في الموضع 1 على سبيل المثال: subsequence(($item1, $item2, $item3,...) ، 3) النتيجة: ($item3, ...) على سبيل المثال: subsequence(($item1, $item2, $item3, ...) ، 2، 2) النتيجة: ($item2, $item3)
fn: unordered( (item,item,...) )	إرجاع العناصر في أمر يعتمد تنفيذ

وظائف هذا اختبار عدد العناصر من متواليات

اسم	وصف
fn:zero-or- one( item,item,... )	ترجع حجة إذا كان يحتوي على صفر أو واحد البنود، وإلا فإنه بإصدار خطأ
fn:one-or- more( item,item,... )	ترجع حجة إذا كان يحتوي على واحد أو أكثر من البنود، وإلا فإنه بإصدار خطأ
fn:exactly- one( item,item,... )	ترجع حجة إذا كان يحتوي على واحد بالضبط البند، وإلا فإنه بإصدار خطأ

قدم المساواة، الاتحاد، تقاطع وباستثناء

اسم	وصف
fn:deep- equal( param1,param2,collation )	عرض true إذا كانت PARAM1 وPARAM2 والعميقة على قدم المساواة مع بعضها البعض، وإلا فإنها ترجع كاذبة

وظائف الكلية

اسم	وصف
fn: count( (item,item,...) )	إرجاع عدد من العقد
fn: avg( (arg,arg,...) )	إرجاع متوسط قيم حجة مثال: avg((1,2,3) ) النتيجة: 2
fn: max( (arg,arg,...) )	ترجع حجة أكبر من الآخرين على سبيل المثال: max((1,2,3) ) النتيجة: 3 على سبيل المثال: max(('a', 'k') ) النتيجة: 'ك'
fn: min( (arg,arg,...) )	إرجاع الحجة التي هي أقل من الآخرين على سبيل المثال: min((1,2,3) ) النتيجة: 1 على سبيل المثال: min(('a', 'k') ) النتيجة: "أ"
fn: sum( arg,arg,... )	إرجاع مجموع قيمة رقمية من كل عقدة في عقدة مجموعة محددة

الوظائف التي توليد متواليات

اسم	وصف
fn: id( (string,string,...) ,node)	بإرجاع سلسلة من العقد العناصر التي لها قيمة ID مساوية لقيمة واحدة أو أكثر من القيم المحددة في حجة سلسلة
fn: idref( (string,string,...) ,node)	بإرجاع سلسلة من عنصر أو سمة العقد التي لها قيمة IDREF مساوية لقيمة واحدة أو أكثر من القيم المحددة في حجة سلسلة
fn: doc( URI )
fn:doc- available( URI )	عرض true إذا كانت doc() الدالة بإرجاع العقدة الوثيقة، وإلا فإنها ترجع كاذبة
fn: collection() fn: collection( string )

وظائف السياق

اسم	وصف
fn: position()	إرجاع موضع فهرس من العقدة التي يجري حاليا معالجتها على سبيل المثال: // كتاب [ position() <= 3] النتيجة: إختيار أول ثلاثة عناصر كتاب
fn: last()	إرجاع عدد من العناصر في القائمة العقدة معالجتها على سبيل المثال: // كتاب [ last() ] النتيجة: إختيار الماضي عنصر كتاب
fn:current- dateTime()	إرجاع التاريخ والوقت الحالي (with timezone)
fn:current- date()	إرجاع التاريخ الحالي (with timezone)
fn:current- time()	إرجاع الوقت الحالي (with timezone)
fn:implicit- timezone()	إرجاع قيمة التوقيت الضمني
fn:default- collation()	إرجاع قيمة الترتيب الافتراضي
fn:static-base- uri()	إرجاع قيمة قاعدة اوري

وظائف XSLT

وبالإضافة إلى ذلك، هناك ما يلي المدمج في وظائف XSLT:

اسم	وصف
current()	إرجاع العقدة الحالية
document()	المستخدمة للوصول إلى عقد في مستند XML الخارجية
element- available()	الاختبارات ما إذا كان العنصر المحدد معتمد من قبل المعالج XSLT
format- number()	تحويل رقم إلى سلسلة
function- available()	اختبارات ما إذا كانت وظيفة محددة معتمد من قبل المعالج XSLT
generate- id()	بإرجاع قيمة السلسلة التي يعرف بشكل فريد العقدة المحددة
key()	ترجع عقدة مجموعة باستخدام الفهرس المحدد من قبل <xsl:key> العنصر
system- property()	إرجاع قيمة خصائص النظام
unparsed-entity- uri()	إرجاع URI من وحدة غير موزع

❮ السابق التالي الفصل ❯

XSLT البرنامج التعليمي

XPath البرنامج التعليمي

XQuery البرنامج التعليمي

المراجع

XSLT كسباث وكسكيري وظائف