دستورالعمل‌های XML

• Element (max. one)
• ProcessingInstruction
• Comment
• DocumentType

• ProcessingInstruction
• Comment
• Text
• CDATASection
• EntityReference

• ProcessingInstruction
• Comment
• Text
• CDATASection
• EntityReference

• Text
• Comment
• ProcessingInstruction
• CDATASection
• EntityReference

• Text
• EntityReference

• ProcessingInstruction
• Comment
• Text
• CDATASection
• EntityReference

اشیاء مرتبط با کلیدهای روی نود را بازمی‌گرداند.

ابتدا باید اشیاء را به این نود تنظیم کنید، از طریق استفاده از کلیدهای مشابه setUserData.

مетод normalize() نود‌های متنی خالی را حذف می‌کند و نود‌های متنی همجوار را به هم می‌چسباند.

تمام نود‌های متنی زیر عنصر (شامل ویژگی‌ها) را正规‌سازی می‌کند، که تنها ساختار‌ها (مثلاً عنصر، نظرات، دستورالعمل‌های پردازش، بخش‌های CDATA و ارجاع‌های فرانت‌تگ) نود‌های متنی را جدا می‌کنند.

یعنی، نه نود‌های متنی همجوار وجود دارند و نه نود‌های متنی خالی وجود دارند.

اگر ارزش ویژگی در مستند تنظیم شده باشد، true بازگرداند؛

اگر ارزش ویژگی DTD/Schema به عنوان ارزش پیش‌فرض باشد، false بازگرداند.

تعیین نوع درخواست، URL، آیا باید درخواست به صورت همزمان پردازش شود و سایر ویژگی‌های اختیاری درخواست.

• method: نوع درخواست: GET یا POST
• url: مکان فایل در سرور
• async: true (آزاد) یا false (همزمان)

درخواست را به سرور ارسال می‌کند.

stringفقط برای درخواست‌های POST استفاده می‌شود

ذخیره وضعیت XMLHttpRequest. تغییرات از 0 تا 4:

• 0: درخواست هنوز تنظیم نشده است
• 1: اتصال سرور برقرار شده
• 2: درخواست دریافت شده
• 3: در حال پردازش درخواست
• 4: درخواست به پایان رسیده، پاسخ آماده است

• 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 را شامل نشود، رشته‌ای از position 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 با مدل مشخص شده مطابقت داشته باشد، مقدار 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。

否则返回带有时区的 dateTime。

如果 timezone 参数为空，则返回没有时区的 date。

否则返回带有时区的 date。

如果 timezone 参数为空，则返回没有时区的 time。

否则返回带有时区的 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 ساخته شده است بازگرداند - در عین حال در موقعیت مشخص شده توسط پارامتر 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[last()]

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