คู่มืออ้างอิง 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 หากค่าขององค์ประกอบถูกตั้งค่าในเอกสาร

คืนค่า false หากค่าขององค์ประกอบเป็นค่าเริ่มต้นใน DTD/Schema

กำหนดชนิดของคำขอ 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

กลับค่าเลขจำนวนที่ใหญ่ที่สุดและเป็นเต็ม

ตัวอย่าง: ceiling(3.14)

คืนค่าตัวเลขเต็มที่แสดงส่วนเดือนในค่าท้องถิ่นของตัวอุปกรณ์

กลับค่าตัวเลขที่เป็นตัวเลขเต็มที่เล็กที่สุดและไม่เกิน num

ตัวอย่าง: floor(3.14)

ผลลัพธ์: 3

ทำให้ num ถูกเรียกเป็นตัวเลขเต็มที่ใกล้ที่สุด

ตัวอย่าง: round(3.14)

ผลลัพธ์: 3

ตัวอย่าง: round-half-to-even(0.5)

คืนค่าตัวเลขเต็มที่แสดงส่วนวินาทีในค่าท้องถิ่นของตัวอุปกรณ์

ตัวอย่าง: 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')

คืนค่าตัวเลขเต็มที่แสดงส่วนวินาทีในค่าท้องถิ่นของตัวอุปกรณ์

กลับค่าแบบเน้นตัวอักษรภาษาไทย

ตัวอย่าง: concat('XPath ','is ','FUN!')

ผลลัพธ์: 'XPath สนุก!'

ใช้ตัวแปร sep ในลำดับต่อมาเป็นตัวแยก แล้วคืนค่าตัวเลขที่ถูกแปลงให้เป็นตัวเลขที่ต่อกัน

ตัวอย่าง: 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 จนถึงตำแหน่ง end ถ้าไม่กำหนด 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'

แทนที่ 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 ก่อนที่ string2 จะปรากฏใน string1

ตัวอย่าง: substring-before('12/10','/')

ผลลัพธ์: '12'

ค้นหาซ้อนของ string2 หลังจากที่ 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"))

คืนค่าตัวเลขเต็มที่แสดงส่วนชั่วโมงในค่าท้องถิ่นของตัวอุปกรณ์

กลับค่าที่มีในประเภทท้องถิ่นที่แสดงชั่วโมงส่วนเต็ม

ตัวอย่าง: 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"))

คืนค่าตัวเลขเต็มที่แสดงส่วนวินาทีในค่าท้องถิ่นของตัวอุปกรณ์

กลับค่าที่มีในประเภทท้องถิ่นที่แสดงวันที่

ตัวอย่าง: year-from-date(xs:date("2005-04-23"))

结果：2005

ผลลัพธ์: 2005

fn:month-from-date(date)

คืนค่าตัวเลขเต็มที่แสดงส่วนเดือนในค่าท้องถิ่นของตัวอุปกรณ์

ผลลัพธ์: 4

fn:day-from-date(date)

คืนค่าตัวเลขเต็มที่แสดงส่วนวันในค่าท้องถิ่นของตัวอุปกรณ์

fn:timezone-from-date(date)

fn:hours-from-time(time)

คืนค่าตัวเลขเต็มที่แสดงส่วนชั่วโมงในค่าท้องถิ่นของตัวอุปกรณ์

ผลลัพธ์: 10

fn:minutes-from-time(time)

คืนค่าตัวเลขเต็มที่แสดงส่วนนาทีในค่าท้องถิ่นของตัวอุปกรณ์

ผลลัพธ์: 22

fn:seconds-from-time(time)

คืนค่าตัวเลขเต็มที่แสดงส่วนวินาทีในค่าท้องถิ่นของตัวอุปกรณ์

คืนค่าส่วน timezone ของตัวอุปกรณ์ ถ้ามี

fn:adjust-dateTime-to-timezone(datetime,timezone)

fn:adjust-date-to-timezone(date,timezone)

ถ้า timezone ไม่มีค่า ก็จะคืนค่า date ที่ไม่มี timezone

ถ้า timezone ไม่มีค่า ก็จะคืนค่า date ที่ไม่มี timezone

ถ้า timezone ไม่มีค่า ก็จะคืนค่า time ที่ไม่มี timezone

• fn:name()
• fn:name(nodeset)

• fn:local-name()
• fn:local-name(nodeset)

• fn:namespace-uri()
• fn:namespace-uri(nodeset)

ถ้าภาษาของตัวเฉพาะปัจจุบันตรงกับภาษาที่กำหนด ก็จะกลับค่า true。

ตัวอย่าง: Lang("en") คือ true สำหรับ <p xml:lang="en">...</p>

ตัวอย่าง: Lang("de") คือ false สำหรับ <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)

กลับค่า index ของตำแหน่งของตัวเลือกที่กำลังประมวลผลขณะนี้

ตัวอย่าง: //book[position()<=3]

ผลลัพธ์: คัดเลือกองค์ประกอบ book สามองค์แรก

กลับคืนจำนวนของรายการในบรรดาตัวเลือกที่ถูกประมวล

ตัวอย่าง: //book[last()]

ผลลัพธ์: การเลือกองค์ประกอบ book สุดท้าย