ایکس کوئری فونکشن

XQuery 1.0، XPath 2.0 اور XSLT 2.0 اسی فونکشن لیبریری کو مشترک کیا کرتے ہیں。

ایکس کوئری فونکشن

XQuery میں 100 سے زیادہ بنیادی فونکشن موجود ہیں، جن کا استعمال کیا جاسکتا ہے جیسے رقمی، تاریخی، وقت کی مقابلو، نیود کا اپنائی، QName آپریشن، سیریل آپریشن، منطقی کی جگہ وغیرہ جیسے اشاروں میں کیا جاسکتا ہے۔ آپ بھی XQuery میں اپنے فونکشن تعین کرسکتے ہیں。

XQuery بنیادی فونکشن

XQuery فونکشن نام فضا کا URI:

http://www.w3.org/2005/02/xpath-functions

فونکشن نام فضا کا مضبوط پرافیکس fn: ہے。

نکات:فونکشن عام طور پر fn: پرافیکس کے ذریعے بولی جاتی ہیں، مثلاً fn:string()۔ لیکن کیونکہ fn: نام فضا کا پرافیکس کے طور پر مضبوط ہے، لہذا فونکشن کا نام بولی جاسکتا ہے جب وہ بولی جائیں تو پرافیکس نہیں استعمال کیا جانا چاہئے。

آپ کو اپنے XPath تعلیم میں پورا کتاب پائا جاسکتا ہے،بنیادی XQuery فونکشن مرجع دستاویز》。

فونکشن کا استعمال مثال

فونکشن کا استعمال کوئی بھی عبارت کے ساتھ استعمال کیا جاسکتا ہے۔ مندرجہ بالا مثال دیکھیئے:

مثال 1: علامت میں

<name>{upper-case($booktitle)}</name>

مثال 2: راستے کی تعریف کی شرط میں

doc("books.xml")/bookstore/book[substring(title,1,5)='Harry']

مثال 3: let بند میں

let $name := (substring($booktitle,1,4))

XQuery کاربر تعین کردہ فونکشن

اگر ضروری XQuery فونکشن نہیں ملتی تو آپ خود فونکشن لکھ سکتے ہیں。

کاربر تعین کردہ فونکشن کو کوئی بھی جگہ کوئی بھی لیبریری میں دفعہ کیا جاسکتا ہے。

گرامر

declare function پرافیکس:فونکشن نام($پارامتر AS نوعیت)
  AS بازگشتی نوعیت
{}}
(: ...فونکشن کوڈ... :)
;

کاربر تعین کردہ فونکشن کے بارے میں توجہ دکھانے والی نکات:

  • declare function کلیدی الفاظ استعمال کریں
  • فونکشن کا نام پہلے پرافیکس استعمال کیا جانا چاہئے
  • پارامتر کا نوعیت عام طور پر XML شکلا میں دفعہ کا نوعیت سے مطابقت رکھتا ہے
  • فونکشن کا بدلہ آئینہ جوڑا ہوا ہوتا ہے

ایک مثال کا استعمال کئے جانے والا کاربر تعین کردہ فونکشن:

declare function local:minPrice(
  $price as xs:decimal?,
  $discount as xs:decimal?)
  AS xs:decimal?
{}}
let $disc := ($price * $discount) div 100
return ($price - $disc)
;
(: اینجا مثال‌های فراخوانی این تابع آمده است :)
<minPrice>{local:minPrice($book/price, $book/discount)}</minPrice>