Class ParserExtension


  • public class ParserExtension
    extends Object
    Dummy Parser extension for syntax in XPath that is accepted only in Saxon-PE and -EE. Primarily, this means XPath 3.0 syntax associated with higher-order functions.
    • Constructor Detail

      • ParserExtension

        public ParserExtension()
    • Method Detail

      • parseNamedFunctionReference

        public Expression parseNamedFunctionReference​(XPathParser p)
                                               throws XPathException
        Parse a literal function item (function#arity). On entry, the function name and the '#' token have already been read
        Parameters:
        p - the parser
        Returns:
        an expression representing the function value
        Throws:
        XPathException - in the event of a syntax error
      • parseFunctionItemType

        public ItemType parseFunctionItemType​(XPathParser p,
                                              AnnotationList annotations)
                                       throws XPathException
        Parse the item type used for function items (XQuery 3.0 higher order functions) Syntax (changed by WG decision on 2009-09-22): function '(' '*' ') | function '(' (SeqType (',' SeqType)*)? ')' 'as' SeqType For backwards compatibility with Saxon 9.2 we allow the "*" to be omitted for the time being The "function(" has already been read
        Parameters:
        annotations - the list of annotation assertions for this function item type
        Throws:
        XPathException
      • parseTildePattern

        public Expression parseTildePattern​(XPathParser p)
                                     throws XPathException
        Parse an extended XSLT pattern in the form ~type-alias (predicate)*
        Returns:
        the equivalent expression in the form .[. instance of type] (predicate)*
        Throws:
        XPathException
      • parseInlineFunction

        protected Expression parseInlineFunction​(XPathParser p,
                                                 AnnotationList annotations)
                                          throws XPathException
        Parse an inline function "function" "(" ParamList? ")" ("as" SequenceType)? EnclosedExpr On entry, "function (" has already been read
        Throws:
        XPathException - if a syntax error is found
      • makeCurriedFunction

        public Expression makeCurriedFunction​(XPathParser parser,
                                              int offset,
                                              StructuredQName name,
                                              Expression[] args,
                                              IntSet placeMarkers)
                                       throws XPathException
        Process a function call in which one or more of the argument positions are represented as "?" placemarkers (indicating partial application or currying)
        Parameters:
        offset - offset in the query source of the start of the expression
        name - the function call (as if there were no currying)
        args - the arguments (with EmptySequence in the placemarker positions)
        placeMarkers - the positions of the placemarkers @return the curried function
        Throws:
        XPathException
      • findOuterRangeVariable

        public LocalBinding findOuterRangeVariable​(XPathParser p,
                                                   StructuredQName qName)
        When a variable reference occurs within an inline function, it might be a reference to a variable declared outside the inline function (which needs to become part of the closure. This code looks for such an outer variable
        Parameters:
        qName - the name of the variable
        Returns:
        a binding for the variable; this will typically be a binding to a newly added parameter for the innermost function in which the variable reference appears. As a side effect, all the inline functions between the declaration of the variable and its use will have this variable as an additional parameter, each one bound to the corresponding parameter in the containing function.
      • parseTypeAliasDeclaration

        public void parseTypeAliasDeclaration​(XQueryParser p)
                                       throws XPathException
        Parse a type alias declaration. Allowed only in Saxon-PE and higher
        Throws:
        XPathException - if parsing fails
      • parseRevalidationDeclaration

        public void parseRevalidationDeclaration​(XQueryParser p)
                                          throws XPathException
        Parse the "declare revalidation" declaration. Syntax: not allowed unless XQuery update is in use
        Throws:
        XPathException - if the syntax is incorrect, or is not allowed in this XQuery processor
      • parseUpdatingFunctionDeclaration

        public void parseUpdatingFunctionDeclaration​(XQueryParser p)
                                              throws XPathException
        Parse an updating function declaration (allowed in XQuery Update only)
        Throws:
        XPathException - if parsing fails or if updating functions are not allowed