Class UntypedAtomicValue

All Implemented Interfaces:
Serializable, Expression, Item, ValueRepresentation

public class UntypedAtomicValue extends StringValue
An Untyped Atomic value. This inherits from StringValue for implementation convenience, even though an untypedAtomic value is not a String in the data model type hierarchy.
See Also:
  • Field Details

  • Constructor Details

    • UntypedAtomicValue

      public UntypedAtomicValue(CharSequence value)
      Constructor
      Parameters:
      value - the String value. Null is taken as equivalent to "".
  • Method Details

    • getItemType

      public ItemType getItemType(TypeHierarchy th)
      Return the type of the expression
      Specified by:
      getItemType in interface Expression
      Overrides:
      getItemType in class StringValue
      Parameters:
      th -
      Returns:
      Type.UNTYPED_ATOMIC (always)
    • convertPrimitive

      public AtomicValue convertPrimitive(BuiltInAtomicType requiredType, boolean validate, XPathContext context)
      Convert to target data type
      Overrides:
      convertPrimitive in class StringValue
      Parameters:
      requiredType - type code of the required atomic type
      validate - true if validation is required. If set to false, the caller guarantees that the value is valid for the target data type, and that further validation is therefore not required. Note that a validation failure may be reported even if validation was not requested.
      context -
      Returns:
      the result of the conversion, if successful. If unsuccessful, the value returned will be a ValidationErrorValue. The caller must check for this condition. No exception is thrown, instead the exception will be encapsulated within the ErrorValue.
    • compareTo

      public int compareTo(Object other, Comparator collator, XPathContext context)
      Compare an untypedAtomic value with another value, using a given collator to perform any string comparisons. This works by converting the untypedAtomic value to the type of the other operand, which is the correct behavior for operators like "=" and "!=", but not for "eq" and "ne": in the latter case, the untypedAtomic value is converted to a string and this method is therefore not used.
      Returns:
      -1 if the this value is less than the other, 0 if they are equal, +1 if this value is greater.
      Throws:
      ClassCastException - if the value cannot be cast to the type of the other operand