book

XSLT 2.0 and XPath 2.0 Programmer's Reference, 4th Edition

Name: XSLT 2.0 and XPath 2.0 Programmer's Reference, 4th Edition
Author: Michael Kay
ISBN: 9780470192740

by Michael Kay

May 2008

Intermediate to advanced

1366 pages

40h 56m

English

Wrox

Read now

Unlock full access

Copyright
About the Author
Credits
Acknowledgments
Introduction
Who This Book Is ForWhat This Book CoversHow This Book Is StructuredPart I: FoundationsChapter 1: XSLT in ContextChapter 2: The XSLT Processing ModelChapter 3: Stylesheet StructureChapter 4: Stylesheets and SchemasChapter 5: The Type SystemPart II: XSLT and XPath ReferenceChapter 6: XSLT ElementsChapter 7: XPath FundamentalsChapter 8: XPath: Operators on ItemsChapter 9: XPath: Path ExpressionsChapter 10: XPath: Sequence ExpressionsChapter 11: XPath: Type ExpressionsChapter 12: XSLT PatternsChapter 13: The Function LibraryChapter 14: Regular ExpressionsChapter 15: SerializationPart III: ExploitationChapter 16: ExtensibilityChapter 17: Stylesheet Design PatternsChapter 18: Case Study: XMLSpecChapter 19: Case Study: A Family TreeChapter 20: Case Study: Knight's TourPart IV: AppendicesAppendix A: XPath 2.0 Syntax SummaryAppendix B: Error CodesAppendix C: Backward CompatibilityAppendix D: Microsoft XSLT ProcessorsAppendix E: JAXP: The Java API for XML ProcessingAppendix F: SaxonAppendix G: AltovaAppendix H: GlossaryIndexWhat You Need to Use This BookConventionsDownloading the CodeErratap2p.wrox.com
List of Examples
Chapter 1Chapter 2Chapter 3Chapter 4Chapter 6Chapter 12Chapter 13Chapter 15Chapter 16Chapter 17Chapter 18Chapter 19Chapter 20Appendix F
I. Foundations
1. XSLT in Context
1.1. What Is XSLT?1.1.1. Why Version 2.0?1.1.2. A Scenario: Transforming Music1.2. How Does XSLT Transform XML?1.2.1. XSLT and SQL: An Analogy1.2.2. XSLT Processors1.2.3. A Simple XSLT Stylesheet1.2.4. An XSLT 2.0 Stylesheet1.3. The Place of XSLT in the XML Family1.3.1. XSLT and XSL Formatting Objects1.3.2. XSLT and XPath1.3.3. XSLT and XML Namespaces1.3.4. XSLT and CSS1.3.5. XSLT and XML Schemas1.3.6. XSLT and XQuery1.4. The History of XSL1.4.1. Prehistory1.4.2. The First XSL Proposal1.4.3. Saxon1.4.4. Beyond XSLT 1.01.4.5. Convergence with XQuery1.4.6. The Development of XSLT 2.0 and XPath 2.01.5. XSLT 2.0 as a Language1.5.1. Use of XML Syntax1.5.2. No Side Effects1.5.3. Rule-Based1.5.4. Types Based on XML Schema1.5.5. A Two-Language System: XSLT and XPath1.6. Summary
2. The XSLT Processing Model
2.1. XSLT: A System Overview2.1.1. A Simplified Overview2.1.2. Trees, Not Documents2.1.3. Different Output Formats2.1.4. Multiple Inputs and Outputs2.2. The XDM Tree Model2.2.1. XML as a Tree2.2.1.1. Nodes in the Tree Model2.2.1.2. The Name of a Node2.2.1.3. The String Value of a Node2.2.1.4. The Typed Value of a Node2.2.1.5. The Type Annotation of a Node2.2.1.6. The Base URI of a Node2.2.1.7. The Children of a Node2.2.1.8. The Parent of a Node2.2.1.9. The Attributes of a Node2.2.1.10. The Namespaces of a Node2.2.2. Completing the UML Class Diagram2.2.3. Document Order2.2.4. Names and Namespaces2.2.4.1. Namespaces: An Overview2.2.4.2. Namespaces in the Data Model2.2.4.3. Namespace Sensitive Content2.2.5. IDs and IDREFs2.2.6. Characters in the Data Model2.2.7. What Does the Tree Leave Out?2.2.8. From Textual XML to a Data Model2.2.9. Controlling Serialization2.3. The Transformation Process2.3.1. Invoking a Transformation2.3.2. Template Rules2.3.2.1. Contents of a Template Rule2.3.2.2. Sequence Constructors2.3.2.3. Nested Sequence Constructors2.3.3. Push Processing2.3.4. Controlling Which Nodes to Process2.3.5. Modes2.3.6. Built-In Template Rules2.3.7. Conflict Resolution Policy2.4. Error Handling2.5. Variables and Expressions2.5.1. Variables2.5.2. Parameters2.5.3. Expressions2.5.4. Context2.5.5. Temporary Documents2.6. Summary
3. Stylesheet Structure
3.1. Changes in XSLT 2.03.2. The Modular Structure of a Stylesheet3.3. The <xsl:stylesheet> Element3.4. The <?xml-stylesheet?> Processing Instruction3.5. Embedded Stylesheets3.6. Declarations3.6.1. XSLT-Defined Declarations3.6.2. Implementor-Defined Declarations3.6.3. User-Defined Top-Level Elements3.7. Instructions3.7.1. XSLT Instructions3.7.2. Extension Instructions3.7.3. Literal Result Elements3.7.3.1. Format3.7.3.2. Position3.7.3.3. Attributes3.7.3.4. Content3.7.3.5. Effect3.7.3.6. Usage3.7.3.7. Attributes of a Literal Result Element3.7.3.8. Namespaces for a Literal Result Element3.7.3.9. Namespace Inheritance3.7.3.10. Namespace Prefixes3.7.3.11. Namespace Aliasing3.7.4. Attribute Value Templates3.8. Simplified Stylesheets3.9. Writing Portable Stylesheets3.9.1. Conditional Compilation3.9.2. Version Compatibility3.9.2.1. Forward Compatibility in XSLT 1.03.9.2.2. Backward Compatibility in XSLT 2.03.9.3. Extensibility3.9.3.1. Extension Functions3.9.3.2. Extension Instructions3.10. Whitespace3.10.1. The Effect of Stripping Whitespace Nodes3.10.2. Whitespace Nodes in the Stylesheet3.10.3. Solving Whitespace Problems3.10.3.1. Too Much Whitespace3.10.3.2. Too Little Whitespace3.11. Summary

4. Stylesheets and Schemas
4.1. XML Schema: An Overview4.1.1. Simple Type Definitions4.1.2. Elements with Attributes and Simple Content4.1.3. Elements with Mixed Content4.1.4. Elements with Element-Only Content4.1.5. Defining a Type Hierarchy4.1.6. Substitution Groups4.2. Declaring Types in XSLT4.3. Validating the Source Document4.4. Validating the Result Document4.5. Validating a Temporary Document4.6. Validating Individual Elements4.7. Validating Individual Attributes4.8. The default-validation Attribute4.9. Importing Schemas4.10. Using xsi:type4.11. Nillability4.12. Summary
5. Types
5.1. What Is a Type System?5.2. Changes in 2.05.3. Sequences5.4. Atomic Values5.5. Atomic Types5.5.1. The Major Atomic Types5.5.1.1. xs:anyURI5.5.1.2. xs:boolean5.5.1.3. xs:date5.5.1.4. xs:dateTime5.5.1.5. xs:decimal5.5.1.6. xs:double5.5.1.7. xs:integer5.5.1.8. xs:QName5.5.1.9. xs:string5.5.1.10. xs:time5.5.1.11. xs:dayTimeDuration and xs:yearMonthDuration5.5.2. The Minor Atomic Types5.5.2.1. The Partial Date Types5.5.2.2. Binary Types5.5.2.3. Single-Precision Floating Point5.5.2.4. The xs:duration Type5.5.2.5. The xs:NOTATION Type5.5.3. Derived Numeric Types5.5.4. Derived String Types5.5.5. Untyped Atomic Values5.5.6. xs:NMTOKENS, xs:IDREFS, and xs:ENTITIES5.6. Schema Types and XPath Types5.7. The Type Matching Rules5.8. Static and Dynamic Type Checking5.9. Summary
II. XSLT and XPath Reference
6. XSLT Elements
6.1. xsl:analyze-string6.1.1. Changes in 2.06.1.2. Format6.1.2.1. Position6.1.2.2. Attributes6.1.2.3. Content6.1.3. Effect6.1.3.1. Regular Expression Syntax6.1.3.2. Captured Groups6.1.4. Usage and Examples6.1.4.1. A Single-Match Example6.1.4.2. A Multiple-Match Example6.1.5. See Also6.2. xsl:apply-imports6.2.1. Changes in 2.06.2.2. Format6.2.2.1. Position6.2.2.2. Attributes6.2.2.3. Content6.2.3. Effect6.2.4. Usage and Examples6.2.5. See Also6.3. xsl:apply-templates6.3.1. Changes in 2.06.3.2. Format6.3.2.1. Position6.3.2.2. Attributes6.3.2.3. Content6.3.3. Effect6.3.3.1. The select Attribute6.3.3.2. Sorting6.3.3.3. Choosing a Template Rule6.3.3.4. Parameters6.3.3.5. Result6.3.4. Usage and Examples6.3.4.1. <xsl:apply-templates> versus <xsl:for-each>6.3.4.2. Modes6.3.4.3. Simulating Higher Order Functions6.3.5. See Also6.4. xsl:attribute6.4.1. Changes in 2.06.4.2. Format6.4.2.1. Position6.4.2.2. Attributes6.4.2.3. Content6.4.3. Effect6.4.3.1. The Name of the Attribute6.4.3.2. Using the New Attribute Node6.4.3.3. The Value of the Attribute6.4.3.4. Validating and Annotating the Attribute6.4.4. Usage6.4.4.1. Different Ways of Creating Attributes6.4.4.2. Creating an Attribute Whose Value Is a QName6.4.5. Examples6.4.6. See Also6.5. xsl:attribute-set6.5.1. Changes in 2.06.5.2. Format6.5.2.1. Position6.5.2.2. Attributes6.5.2.3. Content6.5.3. Effect6.5.4. Usage6.5.5. Examples6.5.6. See Also6.6. xsl:call-template6.6.1. Changes in 2.06.6.2. Format6.6.2.1. Position6.6.2.2. Attributes6.6.2.3. Content6.6.3. Effect6.6.3.1. The Template Name6.6.3.2. Parameters6.6.3.3. Context6.6.4. Usage and Examples6.6.4.1. Using the Result6.6.4.2. Changing the Context Item6.6.4.3. Recursion: Processing a List of Values6.6.5. See Also6.7. xsl:character-map6.7.1. Changes in 2.06.7.2. Format6.7.2.1. Position6.7.2.2. Attributes6.7.2.3. Content6.7.3. Effect6.7.4. Usage and Examples6.7.5. See Also6.8. xsl:choose6.8.1. Changes in 2.06.8.2. Format6.8.2.1. Position6.8.2.2. Attributes6.8.2.3. Content6.8.3. Effect6.8.4. Usage6.8.5. Examples6.8.6. See Also6.9. xsl:comment6.9.1. Changes in 2.06.9.2. Format6.9.2.1. Position6.9.2.2. Attributes6.9.2.3. Content6.9.3. Effect6.9.4. Usage6.9.5. Examples6.9.5.1. Example 1: Showing the Date and Time of Transformation6.9.5.2. Example 2: Generating Commented-Out JavaScript6.9.5.3. Example 3: Generating Comments Containing Markup6.10. xsl:copy6.10.1. Changes in 2.06.10.2. Format6.10.2.1. Position6.10.2.2. Attributes6.10.2.3. Content6.10.3. Effect6.10.4. Usage6.10.5. Examples6.10.6. See Also6.11. xsl:copy-of6.11.1. Changes in 2.06.11.2. Format6.11.2.1. Position6.11.2.2. Attributes6.11.2.3. Content6.11.3. Effect6.11.4. Usage and Examples6.11.4.1. Copying Nodes to and from Temporary Trees6.11.4.2. Deep Copy6.11.4.3. Copying Namespace Nodes6.11.4.4. Copying Type Annotations6.11.5. See Also6.12. xsl:decimal-format6.12.1. Changes in 2.06.12.2. Format6.12.2.1. Position6.12.2.2. Attributes6.12.2.3. Content6.12.3. Effect6.12.4. Usage6.12.5. Examples6.12.5.1. Example 1: Comma as a Decimal Separator6.12.5.2. Example 2: Non-Western Digits6.12.5.3. Example 3: NaN and Infinity6.12.6. See Also6.13. xsl:document6.13.1. Changes in 2.06.13.2. Format6.13.2.1. Position6.13.2.2. Attributes6.13.2.3. Content6.13.3. Effect6.13.3.1. The Content of the Document6.13.3.2. Validating and Annotating the Document6.13.4. Usage and Examples6.13.5. See Also6.14. xsl:element6.14.1. Changes in 2.06.14.2. Format6.14.2.1. Position6.14.2.2. Attributes6.14.2.3. Content6.14.3. Effect6.14.3.1. The Name of the Element6.14.3.2. The Content of the Element6.14.3.3. Namespace Fixup6.14.3.4. Namespace Inheritance6.14.3.5. Validating and Annotating the Element6.14.4. Usage and Examples6.14.5. See Also6.15. xsl:fallback6.15.1. Changes in 2.06.15.2. Format6.15.2.1. Position6.15.2.2. Attributes6.15.2.3. Content6.15.3. Effect6.15.4. Usage6.15.5. Examples6.15.5.1. Example 1: XSLT Forward Compatibility6.15.5.2. Example 2: Vendor Portability6.15.5.3. Example 3: Temporary Trees6.15.6. See Also6.16. xsl:for-each6.16.1. Changes in 2.06.16.2. Format6.16.2.1. Position6.16.2.2. Attributes6.16.2.3. Content6.16.3. Effect6.16.3.1. The select Attribute6.16.3.2. Sorting6.16.4. Usage and Examples6.16.4.1. Iterating over a Sequence of Nodes6.16.4.2. Changing the Context Item6.16.5. See Also6.17. xsl:for-each-group6.17.1. Changes in 2.06.17.2. Format6.17.2.1. Position6.17.2.2. Attributes6.17.2.3. Content6.17.3. Effect6.17.3.1. group-by6.17.3.2. group-adjacent6.17.3.3. group-starting-with6.17.3.4. group-ending-with6.17.3.5. Sorting the Groups6.17.4. Usage and Examples6.17.4.1. Using group-by6.17.4.2. Using group-adjacent6.17.4.3. Using group-starting-with6.17.4.4. Using group-ending-with6.17.4.5. Arranging Data in Tables6.17.5. See Also6.18. xsl:function6.18.1. Changes in 2.06.18.2. Format6.18.2.1. Position6.18.2.2. Attributes6.18.2.3. Content6.18.3. Effect6.18.3.1. The override Attribute6.18.4. Usage and Examples6.18.4.1. Functions versus Named Templates6.18.4.2. Recursion6.18.5. See Also6.19. xsl:if6.19.1. Changes in 2.06.19.2. Format6.19.2.1. Position6.19.2.2. Attributes6.19.2.3. Content6.19.3. Effect6.19.4. Usage6.19.5. Examples6.19.6. See Also6.20. xsl:import6.20.1. Changes in 2.06.20.2. Format6.20.2.1. Position6.20.2.2. Attributes6.20.2.3. Content6.20.3. Effect6.20.3.1. Locating the Stylesheet Module6.20.3.2. Determining the Import Precedence6.20.3.3. Effect of Import Precedence6.20.4. Usage6.20.5. Examples6.20.6. See Also6.21. xsl:import-schema6.21.1. Changes in 2.06.21.2. Format6.21.2.1. Position6.21.2.2. Attributes6.21.2.3. Content6.21.3. Effect6.21.4. Usage6.21.5. Examples6.22. xsl:include6.22.1. Changes in 2.06.22.2. Format6.22.2.1. Position6.22.2.2. Attributes6.22.2.3. Content6.22.3. Effect6.22.4. Usage and Examples6.22.5. See Also6.23. xsl:key6.23.1. Changes in 2.06.23.2. Format6.23.2.1. Position6.23.2.2. Attributes6.23.2.3. Content6.23.3. Effect6.23.4. Usage and Examples6.23.4.1. Keys versus IDs6.23.4.2. Using a Simple Key6.23.4.3. Multivalued Keys6.23.4.4. Multiple Named Keys6.23.4.5. Multiple Definitions for the Same Key6.23.4.6. Composite Keys6.23.4.7. Using Keys for Grouping6.23.5. See Also6.24. xsl:matching-substring6.24.1. Changes in 2.06.24.2. Format6.24.2.1. Position6.24.2.2. Attributes6.24.2.3. Content6.24.3. Effect6.24.4. Usage and Examples6.24.5. See Also6.25. xsl:message6.25.1. Changes in 2.06.25.2. Format6.25.2.1. Position6.25.2.2. Attributes6.25.2.3. Content6.25.3. Effect6.25.4. Usage6.25.5. Examples6.25.5.1. Localized Messages6.25.6. See Also6.26. xsl:namespace6.26.1. Changes in 2.06.26.2. Format6.26.2.1. Position6.26.2.2. Attributes6.26.2.3. Content6.26.3. Effect6.26.4. Usage and Examples6.26.5. See Also6.27. xsl:namespace-alias6.27.1. Changes in 2.06.27.2. Format6.27.2.1. Position6.27.2.2. Attributes6.27.2.3. Content6.27.3. Effect6.27.4. Usage and Examples6.27.4.1. Aliasing the XML Namespace6.27.4.2. Choice of Prefixes in the Result Document6.27.5. See Also6.28. xsl:next-match6.28.1. Changes in 2.06.28.2. Format6.28.2.1. Position6.28.2.2. Attributes6.28.2.3. Content6.28.3. Effect6.28.4. Usage and Examples6.28.5. See Also6.29. xsl:non-matching-substring6.29.1. Changes in 2.06.29.2. Format6.29.2.1. Position6.29.2.2. Attributes6.29.2.3. Content6.29.3. Effect6.29.4. Usage and Examples6.29.5. See Also6.30. xsl:number6.30.1. Changes in 2.06.30.2. Format6.30.2.1. Position6.30.2.2. Attributes6.30.2.3. Content6.30.3. Effect6.30.3.1. Determining a Sequence Number6.30.3.2. Analyzing the Format String6.30.3.3. Formatting the Numbers6.30.3.4. Outputting the Number6.30.4. Usage and Examples6.30.4.1. level = "single"6.30.4.2. level = "any"6.30.4.3. level = "multiple"6.30.5. See Also6.31. xsl:otherwise6.31.1. Changes in 2.06.31.2. Format6.31.2.1. Position6.31.2.2. Attributes6.31.2.3. Content6.31.3. Effect6.31.4. Usage and Examples6.31.5. See Also6.32. xsl:output6.32.1. Changes in 2.06.32.2. Format6.32.2.1. Position6.32.2.2. Attributes6.32.3. Content6.32.4. Effect6.32.5. Examples6.32.6. See Also6.33. xsl:output-character6.33.1. Changes in 2.06.33.2. Format6.33.2.1. Position6.33.2.2. Attributes6.33.2.3. Content6.33.3. Effect6.33.4. See Also6.34. xsl:param6.34.1. Changes in 2.06.34.2. Format6.34.2.1. Format for Stylesheet Parameters6.34.2.2. Format for Template Parameters6.34.2.3. Format for Function Parameters6.34.2.4. Position6.34.2.5. Attributes6.34.2.6. Content6.34.3. Effect6.34.3.1. The Type of the Parameter6.34.3.2. The Default Value of the Parameter6.34.3.3. The Name of the Parameter6.34.3.4. Tunnel Parameters6.34.4. Usage6.34.4.1. Using Stylesheet Parameters6.34.4.2. Using Template Parameters6.34.4.3. Using Tunnel Parameters6.34.5. Examples6.34.6. See Also6.35. xsl:perform-sort6.35.1. Changes in 2.06.35.2. Format6.35.2.1. Position6.35.2.2. Attributes6.35.2.3. Content6.35.3. Effect6.35.4. Usage and Examples6.35.5. See Also6.36. xsl:preserve-space6.36.1. Changes in 2.06.36.2. Format6.36.2.1. Position6.36.2.2. Attributes6.36.2.3. Content6.36.3. Effect6.36.4. Usage6.36.5. Examples6.36.6. See Also6.37. xsl:processing-instruction6.37.1. Changes in 2.06.37.2. Format6.37.2.1. Position6.37.2.2. Attributes6.37.2.3. Content6.37.3. Effect6.37.4. Usage6.37.5. Examples6.38. xsl:result-document6.38.1. Changes in 2.06.38.2. Format6.38.2.1. Position6.38.2.2. Attributes6.38.2.3. Content6.38.3. Effect6.38.4. Usage6.38.5. Examples6.38.6. See Also6.39. xsl:sequence6.39.1. Changes in 2.06.39.2. Format6.39.2.1. Position6.39.2.2. Attributes6.39.2.3. Content6.39.3. Effect6.39.4. Usage and Examples6.39.5. See Also6.40. xsl:sort6.40.1. Changes in 2.06.40.2. Format6.40.2.1. Position6.40.2.2. Attributes6.40.2.3. Content6.40.3. Effect6.40.3.1. Collations6.40.4. Usage6.40.4.1. Using Collations6.40.4.2. Dynamic Sort Keys6.40.5. Examples6.40.6. See Also6.41. xsl:strip-space6.41.1. Changes in 2.06.41.2. Format6.41.2.1. Position6.41.2.2. Attributes6.41.2.3. Content6.41.3. Effect, Usage, and Examples6.41.4. See Also6.42. xsl:stylesheet6.42.1. Changes in 2.06.42.2. Format6.42.2.1. Position6.42.2.2. Namespace Declarations6.42.2.3. Attributes6.42.2.4. Content6.42.3. The id Attribute6.42.3.1. Effect6.42.3.2. Usage6.42.4. The default-collation Attribute6.42.4.1. Effect6.42.4.2. Usage6.42.5. The default-validation Attribute6.42.5.1. Effect6.42.5.2. Usage6.42.6. The exclude-result-prefixes Attribute6.42.6.1. Effect6.42.6.1.1. What exclude-result-prefixes Does6.42.6.1.2. What exclude-result-prefixes Doesn't Do6.42.6.2. Usage6.42.7. The extension-element-prefixes Attribute6.42.7.1. Effect6.42.7.2. Usage6.42.8. The input-type-annotations Attribute6.42.8.1. Effect6.42.8.2. Usage6.42.9. The use-when Attribute6.42.9.1. Effect6.42.9.2. Usage6.42.10. The version Attribute6.42.10.1. Effect6.42.10.2. Usage6.42.11. The xpath-default-namespace Attribute6.42.11.1. Effect6.42.11.2. Usage6.42.12. See Also6.43. xsl:template6.43.1. Changes in 2.06.43.2. Format6.43.2.1. Position6.43.2.2. Attributes6.43.2.3. Content6.43.3. Effect6.43.3.1. The match Attribute6.43.3.2. The name Attribute6.43.3.3. The priority Attribute6.43.3.4. The mode Attribute6.43.3.5. Evaluating a Template6.43.4. Usage and Examples6.43.4.1. Using Template Rules6.43.4.2. Using Modes6.43.5. See Also6.44. xsl:text6.44.1. Changes in 2.06.44.2. Format6.44.2.1. Position6.44.2.2. Attributes6.44.2.3. Content6.44.3. Effect6.44.4. Usage6.44.4.1. Whitespace Control6.44.4.2. Examples6.44.5. See Also6.45. xsl:transform6.45.1. Format6.45.2. See Also6.46. xsl:value-of6.46.1. Changes in 2.06.46.2. Format6.46.2.1. Position6.46.2.2. Attributes6.46.2.3. Content6.46.3. Effect6.46.4. Usage6.46.4.1. Avoiding Surprises6.46.5. Examples6.46.6. See Also6.47. xsl:variable6.47.1. Changes in 2.06.47.2. Format6.47.2.1. Position6.47.2.2. Attributes6.47.2.3. Content6.47.3. Effect6.47.3.1. The Name of the Variable6.47.3.2. The Value of the Variable6.47.3.3. Standard Conversion Rules6.47.4. Usage6.47.5. Examples6.47.5.1. Convenience Variables6.47.5.2. Variables to Capture Context-Sensitive Values6.47.5.3. Variables to Hold Intermediate Results6.47.5.4. Avoiding Trivial Documents6.47.6. See Also6.48. xsl:when6.48.1. Changes in 2.06.48.2. Format6.48.2.1. Position6.48.2.2. Attributes6.48.2.3. Content6.48.3. Effect6.48.4. Usage and Examples6.48.5. See Also6.49. xsl:with-param6.49.1. Changes in 2.06.49.2. Format6.49.2.1. Position6.49.2.2. Attributes6.49.2.3. Content6.49.3. Effect6.49.4. Usage and Examples6.49.5. See Also6.50. Summary
7. XPath Fundamentals
7.1. Notation7.2. Where to Start7.3. Expressions7.3.1. Examples7.4. Lexical Constructs7.4.1. Comments7.4.1.1. Changes in XPath 2.07.4.2. Numeric Literals7.4.2.1. Examples7.4.2.2. Changes in XPath 2.07.4.3. String Literals7.4.3.1. Examples7.4.3.2. Changes in XPath 2.07.4.3.3. XSLT Usage7.4.4. Names7.4.4.1. Examples7.4.4.2. XSLT Usage7.4.5. Operators7.5. Primary Expressions7.5.1. Examples7.6. Variable References7.6.1. Usage7.6.2. Examples7.7. Parenthesized Expressions7.7.1. Changes in XPath 2.07.8. Context Item Expressions7.8.1. Changes in XPath 2.07.8.2. Usage7.9. Function Calls7.9.1. Identifying the Function to Be Called7.9.2. Converting the Arguments and the Result7.9.3. Changes in XPath 2.07.9.4. Side Effects7.9.5. Examples7.10. Conditional Expressions7.10.1. Changes in XPath 2.07.10.2. Examples7.11. The XPath Evaluation Context7.11.1. The Static Context7.11.1.1. XPath 1.0 Compatibility Mode7.11.1.2. In-Scope Namespaces7.11.1.3. Default Namespaces7.11.1.4. In-Scope Schema Definitions7.11.1.5. In-Scope Variables7.11.1.6. In-Scope Functions7.11.1.7. Collations7.11.1.8. Base URI7.11.1.9. Statically Known Documents and Collections7.11.2. The Dynamic Context7.11.2.1. The Focus7.11.2.2. Variable Values7.11.2.3. Function Implementations7.11.2.4. Current dateTime7.11.2.5. Implicit Timezone7.11.2.6. Available Documents and Collections7.12. Summary
8. XPath: Operators on Items
8.1. Arithmetic Operators8.1.1. Syntax8.1.2. Type Promotion8.1.3. Changes in XPath 2.08.1.4. Effect8.1.5. Arithmetic Using Numbers8.1.5.1. Integer Arithmetic8.1.5.2. Decimal Arithmetic8.1.5.3. Floating-Point Arithmetic8.1.6. Examples of Numeric Arithmetic8.1.7. Arithmetic Using Durations8.1.7.1. Date/Time Plus Duration8.1.7.2. Duration Plus Duration8.1.7.3. Duration Times Number8.1.7.4. Date/Time Minus Date/Time8.1.7.5. Duration Divided by Duration8.2. Value Comparisons8.2.1. Permitted Operand Types8.2.2. Type Checking for Value Comparisons8.2.3. Examples of Value Comparisons8.3. General Comparisons8.3.1. Changes in XPath 2.08.3.2. Rules for General Comparisons8.3.3. Existential Comparison8.3.4. Examples of General Comparisons8.4. Node Comparisons8.4.1. The «is» Operator8.4.2. The operators «<<» and «>>»8.4.3. Changes in XPath 2.08.5. Boolean Expressions8.5.1. Shortcut Semantics8.5.2. Examples8.6. Summary
9. XPath: Path Expressions
9.1. Examples of Path Expressions9.2. Changes in XPath 2.09.3. Document Order and Duplicates9.4. The Binary « /» Operator9.4.1. Syntax9.4.2. Effect9.4.3. Examples of the Binary «/» Operator9.4.4. Associativity of the «/» Operator9.5. Axis Steps9.5.1. Syntax of Axis Steps9.5.2. Effect9.5.3. Examples of Axis Steps9.5.4. Axes9.5.5. Node Tests9.5.5.1. Usage9.5.5.2. Examples of Node Tests9.5.6. Name Tests9.5.6.1. Syntax9.5.6.2. Usage9.5.6.3. Examples of Name Tests9.5.7. Kind Tests9.5.7.1. Usage9.5.7.2. Examples of Kind Tests9.5.8. Predicates9.5.9. Abbreviated Axis Steps9.5.9.1. Syntax9.5.9.2. Defaulting the Axis Name in a Step9.5.9.3. The «@» Abbreviation9.5.9.3.1. Examples9.5.9.4. The «..» Abbreviation9.5.9.4.1. Examples in Context9.5.9.5. The Root Expression «/»9.6. Rooted Path Expressions9.6.1. Syntax9.6.2. Examples of Rooted Paths9.7. The « //» Abbreviation9.7.1. Examples Using «//»9.7.2. Comparing «//» with «/descendant::»9.8. Combining Sets of Nodes9.8.1. Syntax9.8.2. Examples9.8.3. Usage9.8.4. Set Intersection and Difference in XPath 1.09.8.5. Sets of Atomic Values9.9. Summary
10. XPath: Sequence Expressions
10.1. The Comma Operator10.1.1. Examples10.2. Numeric Ranges: The «to» Operator10.2.1. Examples10.3. Filter Expressions10.3.1. Examples10.4. The «for» Expression10.4.1. Mapping a Sequence10.4.2. Examples10.4.3. The Context Item in a «for» Expression10.4.4. Combining Multiple Sequences10.4.5. Example10.5. Simple Mapping Expressions10.6. The «some» and «every» Expressions10.6.1. Examples10.6.2. Quantification and the «=» Operator10.6.3. Errors in «some» and «every» Expressions10.7. Summary
11. XPath: Type Expressions
11.1. Converting Atomic Values11.1.1. Converting between Primitive Types11.1.1.1. Converting from anyURI11.1.1.2. Converting from base64Binary11.1.1.3. Converting from boolean11.1.1.4. Converting from date11.1.1.5. Converting from dateTime11.1.1.6. Converting from decimal11.1.1.7. Converting from double11.1.1.8. Converting from duration11.1.1.9. Converting from float11.1.1.10. Converting from gDay11.1.1.11. Converting from gMonth11.1.1.12. Converting from gMonthDay11.1.1.13. Converting from gYear11.1.1.14. Converting from gYearMonth11.1.1.15. Converting from hexBinary11.1.1.16. Converting from NOTATION11.1.1.17. Converting from QName11.1.1.18. Converting from string11.1.1.19. Converting from time11.1.1.20. Converting from untypedAtomic11.1.2. Converting between Derived Types11.1.2.1. Casting from xs:string to a Derived Type11.1.2.2. Converting Non-string Values to a Derived Type11.1.2.3. Casting to an xs:integer11.1.2.4. Casting to xs:yearMonthDuration and xs:dayTimeDuration11.2. Sequence Type Descriptors11.2.1. Matching Atomic Values11.2.2. Matching Nodes11.2.3. Matching Elements and Attributes11.2.3.1. Using Global Element and Attribute Declarations11.2.3.2. Examples11.3. The «instance of» Operator11.4. The «treat as» Operator11.5. Summary
12. XSLT Patterns
12.1. Patterns and Expressions12.2. Changes in XSLT 2.012.3. The Formal Definition12.3.1. Applying the Definition in Practice12.3.2. An Algorithm for Matching Patterns12.3.3. Patterns Containing Predicates12.4. An Informal Definition12.5. Conflict Resolution12.6. Matching Parentless Nodes12.7. The Syntax of Patterns12.7.1. Pattern12.7.1.1. Syntax12.7.1.2. Effect12.7.1.3. Usage12.7.1.4. Examples12.7.2. PathPattern12.7.2.1. Syntax12.7.2.2. Effect12.7.2.3. Usage12.7.2.4. Examples12.7.3. RelativePathPattern12.7.3.1. Syntax12.7.3.2. Effect12.7.3.3. Usage12.7.3.4. Examples12.7.4. PatternStep12.7.4.1. Syntax12.7.4.2. Effect12.7.4.2.1. The PatternAxis12.7.4.2.2. The NameTest12.7.4.2.3. The KindTest12.7.4.2.4. KindTests for Element Nodes12.7.4.2.5. KindTests for Attribute Nodes12.7.4.2.6. KindTests for Document Nodes12.7.4.2.7. Using KindTests12.7.4.2.8. Predicates12.7.4.3. Examples12.7.5. IdKeyPattern12.7.5.1. Syntax12.7.5.2. Usage12.7.5.3. Examples12.8. Summary
13. The Function Library
13.1. A Word about Naming13.2. Functions by Category13.2.1. Boolean Functions13.2.2. Numeric Functions13.2.3. String Functions13.2.4. Date and Time Functions13.2.5. Duration Functions13.2.6. Aggregation Functions13.2.7. Functions on URIs13.2.8. Functions on QNames13.2.9. Functions on Sequences13.2.10. Functions That Return Properties of Nodes13.2.11. Functions That Find Nodes13.2.12. Functions That Return Context Information13.2.13. Diagnostic Functions13.2.14. Functions That Return Information about the XSLT Environment13.2.15. Functions That Assert a Static Type13.3. Notation13.4. Code Samples13.5. Function Definitions13.5.1. abs13.5.1.1. Signature13.5.1.2. Effect13.5.1.3. Examples13.5.2. adjust-date-to-timezone, adjust-dateTime-to-timezone, adjust-time-to-timezone13.5.2.1. Signature13.5.2.2. Effect13.5.2.3. Examples13.5.2.4. Usage13.5.2.5. See Also13.5.3. avg13.5.3.1. Signature13.5.3.2. Effect13.5.3.3. Examples13.5.3.4. See Also13.5.4. base-uri13.5.4.1. Signature13.5.4.2. Effect13.5.4.3. Usage and Examples13.5.4.4. See Also13.5.5. boolean13.5.5.1. Changes in 2.013.5.5.2. Signature13.5.5.3. Effect13.5.5.4. Examples13.5.5.5. Usage13.5.5.6. XSLT Examples13.5.5.7. See Also13.5.6. ceiling13.5.6.1. Changes in 2.013.5.6.2. Signature13.5.6.3. Effect13.5.6.4. Examples13.5.6.5. Usage13.5.6.6. See Also13.5.7. codepoint-equal13.5.7.1. Signature13.5.7.2. Effect13.5.7.3. Examples13.5.7.4. See Also13.5.8. codepoints-to-string13.5.8.1. Signature13.5.8.2. Effect13.5.8.3. Examples13.5.8.4. Usage13.5.8.5. See Also13.5.9. collection13.5.9.1. Signature13.5.9.2. Effect13.5.9.3. See Also13.5.10. compare13.5.10.1. Signature13.5.10.2. Effect13.5.10.3. Examples13.5.10.4. Usage13.5.10.5. See Also13.5.11. concat13.5.11.1. Changes in 2.013.5.11.2. Signature13.5.11.3. Effect13.5.11.4. Examples13.5.11.5. Usage in XSLT13.5.11.6. See Also13.5.12. contains13.5.12.1. Changes in 2.013.5.12.2. Signature13.5.12.3. Effect13.5.12.4. Examples13.5.12.5. Usage13.5.12.6. See Also13.5.13. count13.5.13.1. Changes in 2.013.5.13.2. Signature13.5.13.3. Effect13.5.13.4. Examples13.5.13.5. Usage13.5.13.6. See Also13.5.14. current13.5.14.1. Changes in 2.013.5.14.2. Signature13.5.14.3. Effect13.5.14.4. Usage13.5.14.5. Example13.5.15. current-date, current-dateTime, current-time13.5.15.1. Signature13.5.15.2. Effect13.5.15.3. Examples13.5.15.4. Usage13.5.15.5. See Also13.5.16. current-group13.5.16.1. Signature13.5.16.2. Effect13.5.16.3. Usage and Examples13.5.16.4. See Also13.5.17. current-grouping-key13.5.17.1. Signature13.5.17.2. Effect13.5.17.3. Usage and Examples13.5.17.4. See Also13.5.18. current-time13.5.19. data13.5.19.1. Signature13.5.19.2. Effect13.5.19.3. Examples13.5.19.4. Usage13.5.19.5. See Also13.5.20. dateTime13.5.20.1. Signature13.5.20.2. Effect13.5.20.3. Examples13.5.20.4. See Also13.5.21. day-from-date, day-from-dateTime13.5.21.1. Signature13.5.21.2. Effect13.5.21.3. Examples13.5.21.4. See Also13.5.22. days-from-duration13.5.22.1. Signature13.5.22.2. Effect13.5.22.3. Examples13.5.22.4. See Also13.5.23. deep-equal13.5.23.1. Signature13.5.23.2. Effect13.5.23.3. Examples13.5.23.4. Usage13.5.24. default-collation13.5.24.1. Signature13.5.24.2. Usage13.5.24.3. See Also13.5.25. distinct-values13.5.25.1. Signature13.5.25.2. Effect13.5.25.3. Examples13.5.25.4. Usage13.5.25.5. See Also13.5.26. doc, doc-available13.5.26.1. Changes in 2.013.5.26.2. Signatures13.5.26.2.1. The doc() function13.5.26.2.2. The doc-available() function13.5.26.3. Effect13.5.26.4. Usage and Examples13.5.26.5. See Also13.5.27. document13.5.27.1. Changes in 2.013.5.27.2. Signature13.5.27.3. Effect13.5.27.4. Resolving the URI13.5.27.5. Parsing the Document13.5.27.6. URIs Held in Nodes13.5.27.6.1. Usage: document() Applied to Nodes13.5.27.7. URIs as Atomic Values13.5.27.7.1. Usage: document() Applied to Atomic Values13.5.27.8. Supplying an Explicit Base URI13.5.27.9. See Also13.5.28. document-uri13.5.28.1. Signature13.5.28.2. Effect13.5.28.3. Usage13.5.28.4. See Also13.5.29. element-available13.5.29.1. Changes in 2.013.5.29.2. Signature13.5.29.3. Effect13.5.29.4. Usage and Examples13.5.29.4.1. Testing for Features Available in Later XSLT Versions13.5.29.5. Testing for Vendor Extensions13.5.29.6. See Also13.5.30. empty13.5.30.1. Signature13.5.30.2. Effect13.5.30.3. Examples13.5.30.4. Usage13.5.30.5. See Also13.5.31. encode-for-uri13.5.31.1. Signature13.5.31.2. Effect13.5.31.3. Examples13.5.31.4. Usage13.5.31.5. See Also13.5.32. ends-with13.5.32.1. Signature13.5.32.2. Effect13.5.32.3. Examples13.5.32.4. Usage13.5.32.5. See Also13.5.33. error13.5.33.1. Signature13.5.33.2. Effect13.5.33.3. Examples13.5.33.4. Usage13.5.33.5. See Also13.5.34. escape-html-uri13.5.34.1. Signature13.5.34.2. Effect13.5.34.3. Examples13.5.34.4. Usage13.5.34.5. See Also13.5.35. exactly-one13.5.35.1. Signature13.5.35.2. Effect13.5.35.3. Examples13.5.35.4. Usage13.5.35.5. See Also13.5.36. exists13.5.36.1. Signature13.5.36.2. Effect13.5.36.3. Examples13.5.36.4. Usage13.5.36.5. See Also13.5.37. false13.5.37.1. Changes in 2.013.5.37.2. Signature13.5.37.3. Usage13.5.37.4. XSLT Example13.5.37.5. See Also13.5.38. floor13.5.38.1. Changes in 2.013.5.38.2. Signature13.5.38.3. Effect13.5.38.4. Examples13.5.38.5. Usage13.5.38.6. See Also13.5.39. format-date, format-dateTime, format-time13.5.39.1. Signature13.5.39.2. Effect13.5.39.2.1. The Picture Argument13.5.39.2.2. The Language Argument13.5.39.2.3. The Calendar Argument13.5.39.2.4. The Country Argument13.5.39.3. Usage and Examples13.5.39.4. See Also13.5.40. format-number13.5.40.1. Changes in 2.013.5.40.2. Signature13.5.40.3. Effect13.5.40.3.1. The decimal-format Name13.5.40.3.2. The Picture String13.5.40.4. Usage13.5.40.5. Examples13.5.40.6. See Also13.5.41. format-time13.5.42. function-available13.5.42.1. Changes in 2.013.5.42.2. Signature13.5.42.3. Effect13.5.42.4. Usage13.5.42.4.1. Testing for the Existence of System-Defined Functions13.5.42.4.2. Testing for Vendor or Third-Party Extensions13.5.42.5. See Also13.5.43. generate-id13.5.43.1. Changes in 2.013.5.43.2. Signature13.5.43.3. Effect13.5.43.4. Usage and Examples13.5.43.5. See Also13.5.44. hours-from-dateTime, hours-from-time13.5.44.1. Signature13.5.44.2. Effect13.5.44.3. Examples13.5.44.4. See Also13.5.45. hours-from-duration13.5.45.1. Signature13.5.45.2. Effect13.5.45.3. Examples13.5.45.4. See Also13.5.46. id13.5.46.1. Changes in 2.013.5.46.2. Signature13.5.46.3. Effect13.5.46.4. IDs and Validation13.5.46.5. Usage and Examples13.5.46.6. See Also13.5.47. idref13.5.47.1. Signature13.5.47.2. Effect13.5.47.3. IDs and Validation13.5.47.4. Example13.5.47.5. See Also13.5.48. implicit-timezone13.5.48.1. Signature13.5.48.2. Effect13.5.48.3. Example13.5.48.4. See Also13.5.49. index-of13.5.49.1. Signature13.5.49.2. Effect13.5.49.3. Examples13.5.50. in-scope-prefixes13.5.50.1. Changes in 2.013.5.50.2. Signature13.5.50.3. Effect13.5.50.4. Examples13.5.50.5. Usage13.5.50.6. See Also13.5.51. insert-before13.5.51.1. Signature13.5.51.2. Effect13.5.51.3. Examples13.5.51.4. Usage13.5.51.5. See Also13.5.52. iri-to-uri13.5.52.1. Signature13.5.52.2. Effect13.5.52.3. Examples13.5.52.4. Usage13.5.52.5. See Also13.5.53. key13.5.53.1. Changes in 2.013.5.53.2. Signature13.5.53.3. Effect13.5.53.4. Usage and Examples13.5.53.4.1. Using Keys to Find Nodes by Value13.5.53.5. Using Keys for Grouping13.5.53.6. See Also13.5.54. lang13.5.54.1. Changes in 2.013.5.54.2. Signature13.5.54.3. Effect13.5.54.4. Examples13.5.54.5. Usage13.5.55. last13.5.55.1. Changes in 2.013.5.55.2. Signature13.5.55.3. Effect13.5.55.4. Usage13.5.55.5. Usage in XSLT13.5.55.6. See Also13.5.56. local-name13.5.56.1. Changes in 2.013.5.56.2. Signature13.5.56.3. Effect13.5.56.4. Examples13.5.56.5. Usage13.5.56.6. XSLT Example13.5.56.7. See Also13.5.57. local-name-from-QName13.5.57.1. Signature13.5.57.2. Effect13.5.57.3. Examples13.5.57.4. See Also13.5.58. lower-case13.5.58.1. Signature13.5.58.2. Effect13.5.58.3. Examples13.5.58.4. Usage13.5.58.5. See Also13.5.59. matches13.5.59.1. Signature13.5.59.2. Effect13.5.59.3. Examples13.5.59.4. Usage13.5.59.5. See Also13.5.60. max, min13.5.60.1. Signature13.5.60.2. Effect13.5.60.3. Examples13.5.60.4. Usage13.5.61. min13.5.62. minutes-from-dateTime, minutes-from-time13.5.62.1. Signature13.5.62.2. Effect13.5.62.3. Examples13.5.62.4. See Also13.5.63. minutes-from-duration13.5.63.1. Signature13.5.63.2. Effect13.5.63.3. Examples13.5.63.4. See Also13.5.64. minutes-from-time13.5.65. month-from-date, month-from-dateTime13.5.65.1. Signature13.5.65.2. Effect13.5.65.3. Examples13.5.65.4. See Also13.5.66. months-from-duration13.5.66.1. Signature13.5.66.2. Effect13.5.66.3. Examples13.5.66.4. See Also13.5.67. name13.5.67.1. Changes in 2.013.5.67.2. Signature13.5.67.3. Effect13.5.67.4. Usage13.5.67.5. Examples13.5.67.6. See Also13.5.68. namespace-uri13.5.68.1. Changes in 2.013.5.68.2. Signature13.5.68.3. Effect13.5.68.4. Examples13.5.68.5. Usage13.5.68.6. See Also13.5.69. namespace-uri-for-prefix13.5.69.1. Changes in 2.013.5.69.2. Signature13.5.69.3. Effect13.5.69.4. Example13.5.69.5. Usage13.5.69.6. See Also13.5.70. namespace-uri-from-QName13.5.70.1. Signature13.5.70.2. Effect13.5.70.3. Examples13.5.70.4. See Also13.5.71. nilled13.5.71.1. Signature13.5.71.2. Effect13.5.71.3. Examples13.5.71.4. Usage13.5.72. node-name13.5.72.1. Signature13.5.72.2. Effect13.5.72.3. Examples13.5.72.4. Usage13.5.72.5. See Also13.5.73. normalize-space13.5.73.1. Changes in 2.013.5.73.2. Signature13.5.73.3. Effect13.5.73.4. Examples13.5.73.5. Usage13.5.73.6. XSLT Example13.5.73.7. See Also13.5.74. normalize-unicode13.5.74.1. Signature13.5.74.2. Effect13.5.74.3. Usage13.5.74.4. See Also13.5.75. not13.5.75.1. Changes in 2.013.5.75.2. Signature13.5.75.3. Effect13.5.75.4. Examples13.5.75.5. Usage13.5.75.6. XSLT Examples13.5.75.7. See Also13.5.76. number13.5.76.1. Changes in 2.013.5.76.2. Signature13.5.76.3. Effect13.5.76.4. Examples13.5.76.5. Usage13.5.76.6. See Also13.5.77. one-or-more13.5.77.1. Signature13.5.77.2. Effect13.5.77.3. Examples13.5.77.4. Usage13.5.77.5. See Also13.5.78. position13.5.78.1. Changes in 2.013.5.78.2. Signature13.5.78.3. Effect13.5.78.4. Usage in XSLT13.5.78.4.1. Displaying the Current Position13.5.78.4.2. Testing the Current Position13.5.78.5. See Also13.5.79. prefix-from-QName13.5.79.1. Signature13.5.79.2. Effect13.5.79.3. Usage13.5.79.4. Examples13.5.79.5. See Also13.5.80. QName13.5.80.1. Signature13.5.80.2. Effect13.5.80.3. Examples13.5.80.4. Usage13.5.80.5. See Also13.5.81. regex-group13.5.81.1. Signature13.5.81.2. Effect13.5.81.3. Usage and Examples13.5.81.4. See Also13.5.82. remove13.5.82.1. Signature13.5.82.2. Effect13.5.82.3. Examples13.5.82.4. Usage13.5.82.5. See Also13.5.83. replace13.5.83.1. Signature13.5.83.2. Effect13.5.83.3. Examples13.5.83.4. Usage13.5.83.5. See Also13.5.84. resolve-QName13.5.84.1. Signature13.5.84.2. Effect13.5.84.3. Examples13.5.84.4. Usage13.5.84.5. See Also13.5.85. resolve-uri13.5.85.1. Signature13.5.85.2. Effect13.5.85.3. Examples13.5.85.4. Usage13.5.85.5. See Also13.5.86. reverse13.5.86.1. Signature13.5.86.2. Effect13.5.86.3. Examples13.5.86.4. See Also13.5.87. root13.5.87.1. Signature13.5.87.2. Effect13.5.87.3. Examples13.5.87.4. Usage13.5.87.5. See Also13.5.88. round13.5.88.1. Changes in 2.013.5.88.2. Signature13.5.88.3. Effect13.5.88.4. Examples13.5.88.5. Usage13.5.88.6. See Also13.5.89. round-half-to-even13.5.89.1. Signature13.5.89.2. Effect13.5.89.3. Examples13.5.89.4. Usage13.5.89.5. See Also13.5.90. seconds-from-dateTime, seconds-from-time13.5.90.1. Signature13.5.90.2. Effect13.5.90.3. Examples13.5.90.4. See Also13.5.91. seconds-from-duration13.5.91.1. Signature13.5.91.2. Effect13.5.91.3. Examples13.5.91.4. See Also13.5.92. seconds-from-time13.5.93. starts-with13.5.93.1. Changes in 2.013.5.93.2. Signature13.5.93.3. Effect13.5.93.4. Examples13.5.93.5. Usage13.5.93.6. See Also13.5.94. static-base-uri13.5.94.1. Signature13.5.94.2. Effect13.5.94.3. Usage13.5.94.4. See Also13.5.95. string13.5.95.1. Changes in 2.013.5.95.2. Signature13.5.95.3. Effect13.5.95.4. Examples13.5.95.5. Usage13.5.95.6. See Also13.5.96. string-join13.5.96.1. Signature13.5.96.2. Effect13.5.96.3. Examples13.5.96.4. Usage13.5.96.5. See Also13.5.97. string-length13.5.97.1. Changes in 2.013.5.97.2. Signature13.5.97.3. Effect13.5.97.4. Examples13.5.97.5. Usage13.5.97.6. See Also13.5.98. string-to-codepoints13.5.98.1. Signature13.5.98.2. Effect13.5.98.3. Examples13.5.98.4. See Also13.5.99. subsequence13.5.99.1. Signature13.5.99.2. Effect13.5.99.3. Examples13.5.99.4. See Also13.5.100. substring13.5.100.1. Changes in 2.013.5.100.2. Signature13.5.100.3. Effect13.5.100.4. Examples13.5.100.5. Usage13.5.100.5.1. Using substring() as a Conditional Expression13.5.100.6. See Also13.5.101. substring-after13.5.101.1. Changes in 2.013.5.101.2. Signature13.5.101.3. Effect13.5.101.4. Examples13.5.101.5. Usage13.5.101.6. XSLT Example13.5.101.7. See Also13.5.102. substring-before13.5.102.1. Changes in 2.013.5.102.2. Signature13.5.102.3. Effect13.5.102.4. Examples13.5.102.5. Usage and Examples13.5.102.6. See Also13.5.103. sum13.5.103.1. Changes in 2.013.5.103.2. Signature13.5.103.3. Effect13.5.103.4. Examples13.5.103.5. Usage13.5.103.6. See Also13.5.104. system-property13.5.104.1. Changes in 2.013.5.104.2. Signature13.5.104.3. Effect13.5.104.4. Usage13.5.104.5. Examples13.5.104.6. See Also13.5.105. timezone-from-date, timezone-from-dateTime, timezone-from-time13.5.105.1. Signature13.5.105.2. Effect13.5.105.3. Examples13.5.105.4. See Also13.5.106. tokenize13.5.106.1. Signature13.5.106.2. Effect13.5.106.3. Examples13.5.106.4. Usage13.5.106.5. See Also13.5.107. trace13.5.107.1. Signature13.5.107.2. Effect13.5.107.3. Usage and Examples13.5.107.4. See Also13.5.108. translate13.5.108.1. Changes in 2.013.5.108.2. Signature13.5.108.3. Effect13.5.108.4. Examples13.5.108.5. Usage and Examples13.5.108.6. See Also13.5.109. true13.5.109.1. Changes in 2.013.5.109.2. Signature13.5.109.3. Effect13.5.109.4. Usage13.5.109.5. XSLT Example13.5.109.6. See Also13.5.110. type-available13.5.110.1. Signature13.5.110.2. Effect13.5.110.3. Usage13.5.110.4. See Also13.5.111. unordered13.5.111.1. Signature13.5.111.2. Effect13.5.111.3. Usage and Examples13.5.112. unparsed-entity-public-id, unparsed-entity-uri13.5.112.1. Changes in 2.013.5.112.2. Signatures13.5.112.2.1. The unparsed-entity-public-id() function13.5.112.2.2. The unparsed-entity-uri() function13.5.112.3. Effect13.5.112.4. Usage13.5.112.5. Examples13.5.112.6. See Also13.5.113. unparsed-text, unparsed-text-available13.5.113.1. Signatures13.5.113.1.1. The unparsed-text() function13.5.113.1.2. The unparsed-text-available() function13.5.113.2. Effect13.5.113.3. Usage and Examples13.5.113.3.1. Up-Conversion13.5.113.4. XML Envelope/Payload Applications13.5.113.5. HTML Boilerplate Generation13.5.114. See Also13.5.115. upper-case13.5.115.1. Signature13.5.115.2. Effect13.5.115.3. Examples13.5.115.4. Usage13.5.115.5. See Also13.5.116. year-from-date, year-from-dateTime13.5.116.1. Signature13.5.116.2. Effect13.5.116.3. Examples13.5.116.4. See Also13.5.117. years-from-duration13.5.117.1. Signature13.5.117.2. Effect13.5.117.3. Examples13.5.117.4. See Also13.5.118. zero-or-one13.5.118.1. Signature13.5.118.2. Effect13.5.118.3. Examples13.5.118.4. Usage13.5.118.5. See Also13.6. Summary
14. Regular Expressions
14.1. Branches and Pieces14.2. Quantifiers14.3. Atoms14.4. Subexpressions14.5. Back-References14.6. Character Groups14.7. Character Ranges14.8. Character Class Escapes14.9. Character Blocks14.10. Character Categories14.11. Flags14.11.1. The «i» flag14.11.2. The «m» flag14.11.3. The «s» flag14.11.4. The «x» flag14.12. Disallowed Constructs14.13. Summary
15. Serialization
15.1. The XML Output Method15.2. The HTML Output Method15.3. The XHTML Output Method15.4. The Text Output Method15.5. Using the <xsl:output> declaration15.6. Character Maps15.6.1. Usage15.6.2. Choosing Characters to Map15.6.3. Limitations of Character Maps15.7. Disable Output Escaping15.7.1. Reasons to Disable Output Escaping15.7.2. Why disable-output-escaping Is Deprecated15.7.3. Using disable-output-escaping to Wrap HTML in CDATA15.7.4. Character Maps as a Substitute for disable-output-escaping15.8. Summary
III. Exploitation
16. Extensibility
16.1. What Vendor Extensions Are Allowed?16.2. Extension Functions16.2.1. When Are Extension Functions Needed?16.2.2. When Are Extension Functions Not Needed?16.2.3. Calling Extension Functions16.2.4. What Language Is Best?16.2.5. Client-Side Script16.2.6. Binding Extension Functions16.2.6.1. Binding in MSXML16.2.6.2. Binding by Namespace in Java Processors16.2.6.3. Binding Using External Objects in the Microsoft .NET Processor16.2.6.4. Binding to Assemblies in Saxon on .NET16.2.6.5. Binding to Extension Functions in Gestalt16.2.7. XPath Trees and the DOM16.2.8. Calling External Functions within a Loop16.2.9. Functions with Uncontrolled Side Effects16.3. Keeping Extensions Portable16.4. Summary
17. Stylesheet Design Patterns
17.1. Fill-in-the-Blanks Stylesheets17.2. Navigational Stylesheets17.3. Rule-Based Stylesheets17.4. Computational Stylesheets17.4.1. Programming without Assignment Statements17.4.2. So Why Are They Called Variables?17.4.3. Avoiding Assignment Statements17.4.3.1. Conditional Initialization17.4.3.2. Avoid Doing Two Things at Once17.4.3.3. Don't Iterate, Recurse17.4.3.4. Recursion: Summary17.5. Summary
18. Case Study: XMLSpec
18.1. Formatting the XML Specification18.2. Preface18.3. Creating the HTML Outline18.4. Formatting the Document Header18.5. Creating the Table of Contents18.6. Creating Section Headers18.7. Formatting the Text18.8. Producing Lists18.9. Making Cross-References18.10. Setting Out the Production Rules18.11. Overlay Stylesheets18.11.1. diffspec.xsl18.11.2. REC-xml.xsl18.12. Stylesheets for Other Specifications18.12.1. xslt.xsl18.12.2. xsltdiff.xsl18.12.3. funcproto.xsl18.12.4. xsl-query.xsl18.12.5. xmlspec.xsl18.13. Summary
19. Case Study: A Family Tree
19.1. Modeling a Family Tree19.1.1. The GEDCOM Data Model19.1.2. Creating a Schema for GEDCOM 6.019.1.3. The GEDCOM 6.0 Schema19.1.3.1. Individuals19.1.3.2. Events19.1.3.3. Families19.1.3.4. Dates19.1.3.5. Places19.1.3.6. Personal Names19.2. Creating a Data File19.2.1. Converting GEDCOM Files to XML19.2.2. Converting from GEDCOM 5.5 to 6.019.2.2.1. Top-Level Processing19.2.2.2. Creating Family Records19.2.2.3. Creating Individual Records19.2.2.4. Creating Event Records19.2.2.5. Debugging the Stylesheet19.3. Displaying the Family Tree Data19.3.1. The Stylesheet19.3.2. Putting It Together19.3.2.1. Publishing Static HTML19.3.2.2. Generating HTML Pages from a Servlet19.3.2.3. Installing and Configuring the Servlet19.3.2.4. Generating HTML Using ASP.NET Pages19.3.2.5. Generating HTML in the Browser19.4. Summary
20. Case Study: Knight's Tour
20.1. The Problem20.2. The Algorithm20.2.1.20.2.1.1. The Initial Template20.3. Placing the Knight20.4. Displaying the Final Board20.5. Finding the Route20.5.1. Finding the Possible Moves20.5.2. Trying the Possible Moves20.5.3. Selecting the Best Move20.6. Running the Stylesheet20.7. Observations20.8. Summary
IV. Appendices
A. XPath 2.0 Syntax Summary
A.1. Whitespace and CommentsA.2. TokensA.3. Syntax ProductionsA.4. Operator Precedence
B. Error Codes
B.1. Functions and Operators (FO)B.2. XPath Errors (XP)B.3. XSLT Errors (XT)
C. Backward Compatibility
C.1. Stage 1: Backward-Compatibility ModeC.1.1. Deprecated FacilitiesC.1.2. Error HandlingC.1.3. Comparing StringsC.1.4. Numeric FormatsC.1.5. Other XPath ChangesC.1.6. Serialization ChangesC.2. Stage 2: Setting version="2.0"C.2.1. The First Node RuleC.2.2. Type Checking of Function ArgumentsC.2.3. Comparison OperatorsC.2.4. ArithmeticC.2.5. The Empty SequenceC.2.6. Error Semantics for «and» and «or»C.2.7. Other XSLT DifferencesC.3. Stage 3: Adding a SchemaC.4. Summary
D. Microsoft XSLT Processors
D.1. MSXMLD.1.1. ObjectsD.1.2. IXMLDOMDocument and IXMLDOMDocument2D.1.3. Additional MethodsD.1.4. Additional PropertiesD.1.5. IXMLDOMNodeD.1.6. MethodsD.1.7. PropertiesD.1.8. IXMLDOMNodeListD.1.9. MethodsD.1.10. PropertiesD.1.11. IXMLDOMParseErrorD.1.12. PropertiesD.1.13. IXMLDOMSelectionD.1.14. MethodsD.1.15. PropertiesD.1.16. IXSLProcessorD.1.17. MethodsD.1.18. PropertiesD.1.19. IXSLTemplateD.1.20. MethodsD.1.21. PropertiesD.1.22. Putting it TogetherD.1.23. RestrictionsD.2. System.XmlD.2.1. XPathDocumentD.2.2. XmlNodeD.2.3. IXPathNavigableD.2.4. XPathNavigatorD.2.5. XSLTransformD.3. Summary
E. JAXP: The Java API for Transformation
E.1. The JAXP Parser APIE.1.1. JAXP Support for SAXE.1.1.1. javax.xml.parsers.SAXParserFactoryE.1.1.2. javax.xml.parsers.SAXParserE.1.2. JAXP Support for DOME.1.2.1. javax.xml.parsers.DocumentBuilderFactoryE.1.2.2. javax.xml.parsers.DocumentBuilderE.2. The JAXP Transformation APIE.2.1.E.2.1.1. javax.xml.transform.dom.DOMLocatorE.2.1.2. javax.xml.transform.dom.DOMResultE.2.1.3. javax.xml.transform.dom.DOMSourceE.2.1.4. javax.xml.transform.ErrorListenerE.2.1.5. javax.xml.transform.OutputKeysE.2.1.6. javax.xml.transform.ResultE.2.1.7. javax.xml.transform.sax.SAXResultE.2.1.8. javax.xml.transform.sax.SAXSourceE.2.1.9. javax.xml.transform.sax.SAXTransformerFactoryE.2.1.10. javax.xml.transform.SourceE.2.1.11. javax.xml.transform.SourceLocatorE.2.1.12. javax.xml.transform.stream.StreamSourceE.2.1.13. javax.xml.transform.TemplatesE.2.1.14. javax.xml.transform.sax.TemplatesHandlerE.2.1.15. javax.xml.transform.TransformerE.2.1.16. javax.xml.transform.TransformerConfigurationExceptionE.2.1.17. javax.xml.transform.TransformerExceptionE.2.1.18. javax.xml.transform.TransformerFactoryE.2.1.19. javax.xml.transform.TransformerFactoryConfigurationErrorE.2.1.20. javax.xml.transform.sax.TransformerHandlerE.2.1.21. javax.xml.transform.URIResolverE.3. Examples of JAXP TransformationsE.3.1. Example 1: Transformation Using FilesE.3.2. Example 2: Supplying Parameters and Output PropertiesE.3.3. Example 3: Holding Documents in MemoryE.3.4. Example 4: Using the <?xml-stylesheet?> Processing InstructionE.3.5. Example 5: A SAX PipelineE.4. Summary
F. Saxon
F.1. Using Saxon from the Command LineF.2. Using Saxon from a Java ApplicationF.2.1. Using Saxon via JAXP InterfacesF.2.1.1. Running XSLT TransformationsF.2.1.2. The Schema Validation APIF.2.1.3. Using XPath Expressions in SaxonF.2.2. The s9api InterfaceF.3. Using Saxon from a .NET ApplicationF.4. Saxon Tree ModelsF.5. ExtensibilityF.5.1. Writing Extension Functions in JavaF.5.2. Writing Extension Functions under .NETF.5.3. CollationsF.6. ExtensionsF.6.1. Serialization ExtensionsF.6.2. Extension AttributesF.6.3. Extension InstructionsF.6.4. Extension FunctionsF.7. The evaluate() ExtensionF.8. Summary
G. Altova
G.1. Running from within XMLSpyG.2. ConformanceG.3. Extensions and ExtensibilityG.4. The Command Line InterfaceG.5. Using the APIG.5.1. The COM APIG.5.1.1. XMLValidatorG.5.1.2. XSLT2G.5.2. The Java APIG.5.3. The .NET APIG.6. Summary
H. Glossary

Content preview from XSLT 2.0 and XPath 2.0 Programmer's Reference, 4th Edition

Appendix G. Altova

Altova is the company that produces the popular XMLSpy toolkit. Among its many capabilities this includes an XSLT 2.0 processor, which can be used either as part of XMLSpy or on its own from the command line or via one of a number of application programming interfaces. XMLSpy is commercial software that can be purchased from www.altova.com.

Altova's XSLT 2.0 processor is available as a free (but not open source) download from the same site — it is part of a package called AltovaXML that also includes an XML validating parser, an XML Schema processor, an XQuery engine, and an XSLT 1.0 processor. The XQuery and XSLT 2.0 processors are both schema-aware. Although the product is internally a COM component, APIs are offered for COM, Java, and .NET.

As well as the XSLT 2.0 processor itself, XMLSpy also includes an interactive XSLT debugger and a profiler for performance analysis.

Both products run on Windows only. The version described in this chapter is the 2008 edition.

Running from within XMLSpy

An example showing how to run a simple "Hello World" stylesheet from within XMLSpy was given in Chapter 1 (see page 11).

Remember that XMLSpy includes both an XSLT 1.0 and an XSLT 2.0 processor, and the one it uses depends on the «version» attribute in your <xsl:stylesheet> element. If you are writing an XSLT 2.0 stylesheet and you get error messages referring to unrecognized functions or instructions, check that you haven't inadvertently specified «version="1.0"».

When you click ...

Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.

Read now

Unlock full access

More than 5,000 organizations count on O’Reilly

O’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.

Julian F.

Head of Cybersecurity

I wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.

Addison B.

Field Engineer

I’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.

Amir M.

Data Platform Tech Lead

I'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.

Mark W.

Embedded Software Engineer

Publisher Resources

ISBN: 9780470192740Purchase book

Cloud Computing

Data Engineering

Data Science

AI & ML

Programming Languages

Software Architecture

IT/Ops

Security

Design

Business

Soft Skills

XSLT 2.0 and XPath 2.0 Programmer's Reference, 4th Edition

by Michael Kay

Appendix G. Altova

Running from within XMLSpy

Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.