Class UntypedAtomicConverter

    • Constructor Detail

      • UntypedAtomicConverter

        public UntypedAtomicConverter​(Expression sequence,
                                      AtomicType requiredItemType,
                                      boolean allConverted)
        Constructor
        Parameters:
        sequence - this must be a sequence of atomic values. This is not checked; a ClassCastException will occur if the precondition is not satisfied.
        requiredItemType - the item type to which untypedAtomic items in the sequence should be converted, using the rules for "cast as".
        allConverted - true if the result of this expression is a sequence in which all items belong to the required type
    • Method Detail

      • getRequiredItemType

        public ItemType getRequiredItemType()
        Get the item type to which untyped atomic items must be converted
        Returns:
        the required item type
      • areAllItemsConverted

        public boolean areAllItemsConverted()
        Determine whether all items are to be converted, or only the subset that are untypedAtomic
        Returns:
        true if all items are to be converted
      • getItemType

        public ItemType getItemType​(TypeHierarchy th)
        Determine the data type of the items returned by the expression
        Overrides:
        getItemType in class UnaryExpression
        Parameters:
        th - the type hierarchy cache
        Returns:
        the item type of the items in the result sequence, insofar as this is known statically.
      • typeCheck

        public Expression typeCheck​(ExpressionVisitor visitor,
                                    ItemType contextItemType)
                             throws XPathException
        Type-check the expression
        Overrides:
        typeCheck in class UnaryExpression
        Parameters:
        visitor - an expression visitor
        contextItemType - the static type of "." at the point where this expression is invoked. The parameter is set to null if it is known statically that the context item will be undefined. If the type of the context item is not known statically, the argument is set to Type.ITEM_TYPE
        Returns:
        the original expression, rewritten to perform necessary run-time type checks, and to perform other type-related optimizations
        Throws:
        XPathException - if an error is discovered during this phase (typically a type error)
      • copy

        public Expression copy()
        Copy an expression. This makes a deep copy.
        Specified by:
        copy in class Expression
        Returns:
        the copy of the original expression
      • evaluateItem

        public Item evaluateItem​(XPathContext context)
                          throws XPathException
        Evaluate as an Item. This should only be called if the UntypedAtomicConverter has cardinality zero-or-one
        Specified by:
        evaluateItem in interface EvaluableItem
        Overrides:
        evaluateItem in class Expression
        Parameters:
        context - The context in which the expression is to be evaluated
        Returns:
        the node or atomic value that results from evaluating the expression; or null to indicate that the result is an empty sequence
        Throws:
        XPathException - if any dynamic error occurs evaluating the expression
      • explain

        public void explain​(ExpressionPresenter out)
        Diagnostic print of expression structure. The abstract expression tree is written to the supplied output destination.
        Overrides:
        explain in class UnaryExpression
        Parameters:
        out - the expression presenter used to display the structure
      • displayOperator

        protected java.lang.String displayOperator​(Configuration config)
        Description copied from class: UnaryExpression
        Give a string representation of the operator for use in diagnostics
        Overrides:
        displayOperator in class UnaryExpression
        Returns:
        the operator, as a string