net.sf.saxon.value.Int64Value Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of saxon-he Show documentation
Show all versions of saxon-he Show documentation
An OSGi bundle for Saxon-HE
////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
// Copyright (c) 2013 Saxonica Limited.
// This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0.
// If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
// This Source Code Form is "Incompatible With Secondary Licenses", as defined by the Mozilla Public License, v. 2.0.
////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
package net.sf.saxon.value;
import net.sf.saxon.expr.Calculator;
import net.sf.saxon.om.SequenceTool;
import net.sf.saxon.om.StandardNames;
import net.sf.saxon.trans.XPathException;
import net.sf.saxon.type.AtomicType;
import net.sf.saxon.type.BuiltInAtomicType;
import net.sf.saxon.type.ValidationFailure;
import java.math.BigDecimal;
import java.math.BigInteger;
/**
* An integer value: note this is a subtype of decimal in XML Schema, not a primitive type.
* This class supports integer values in the range permitted by a Java "long",
* and also supports the built-in subtypes of xs:integer.
*/
public final class Int64Value extends IntegerValue {
private long value;
/**
* Array of small integer values
*/
/*@NotNull*/ private static final Int64Value[] SMALL_INTEGERS = {
new Int64Value(0),
new Int64Value(1),
new Int64Value(2),
new Int64Value(3),
new Int64Value(4),
new Int64Value(5),
new Int64Value(6),
new Int64Value(7),
new Int64Value(8),
new Int64Value(9),
new Int64Value(10),
new Int64Value(11),
new Int64Value(12),
new Int64Value(13),
new Int64Value(14),
new Int64Value(15),
new Int64Value(16),
new Int64Value(17),
new Int64Value(18),
new Int64Value(19),
new Int64Value(20)
};
/**
* Constructor supplying a long
*
* @param value the value of the IntegerValue
*/
public Int64Value(long value) {
this.value = value;
typeLabel = BuiltInAtomicType.INTEGER;
}
/**
* Constructor for a subtype, supplying a long and a type label.
*
* @param val The supplied value, as an integer
* @param type the required item type, a subtype of xs:integer
* @param check Set to true if the method is required to check that the value is in range;
* false if the caller can guarantee that the value has already been checked.
* @throws XPathException if the supplied value is out of range for the
* target type
*/
public Int64Value(long val, /*@NotNull*/ BuiltInAtomicType type, boolean check) throws XPathException {
value = val;
typeLabel = type;
if (check && !checkRange(value, type)) {
XPathException err = new XPathException("Integer value " + val +
" is out of range for the requested type " + type.getDescription());
err.setErrorCode("XPTY0004");
err.setIsTypeError(true);
throw err;
}
}
/**
* Factory method: allows Int64Value objects to be reused. Note that
* a value obtained using this method must not be modified to set a type label, because
* the value is in general shared.
* @param value the integer value
* @return an Int64Value with this integer value
*/
public static Int64Value makeIntegerValue(long value) {
if (value <= 20 && value >= 0) {
return SMALL_INTEGERS[(int)value];
} else {
return new Int64Value(value);
}
}
/**
* Factory method to create a derived value, with no checking of the value against the
* derived type
* @param val the integer value
* @param type the subtype of xs:integer
* @return the constructed value
*/
/*@NotNull*/ public static Int64Value makeDerived(long val, AtomicType type) {
Int64Value v = new Int64Value(val);
v.typeLabel = type;
return v;
}
/**
* Factory method returning the integer -1, 0, or +1 according as the argument
* is negative, zero, or positive
* @param val the value to be tested
* @return the Int64Value representing -1, 0, or +1
*/
public static Int64Value signum(long val) {
if (val == 0) {
return IntegerValue.ZERO;
} else {
return (val < 0 ? IntegerValue.MINUS_ONE : IntegerValue.PLUS_ONE);
}
}
/**
* Create a copy of this atomic value, with a different type label
*
* @param typeLabel the type label of the new copy. The caller is responsible for checking that
* the value actually conforms to this type.
*/
/*@NotNull*/ public AtomicValue copyAsSubType(/*@NotNull*/ AtomicType typeLabel) {
if (typeLabel.getPrimitiveType() == StandardNames.XS_INTEGER) {
Int64Value v = new Int64Value(value);
v.typeLabel = typeLabel;
return v;
} else {
return new DecimalValue(value);
}
}
/**
* Convert the value to a subtype of xs:integer
* @param subtype the target subtype
* @param validate true if validation is required; false if the caller already knows that the value is valid
* @return null if the conversion succeeds; a ValidationFailure describing the failure if it fails. Note
* that the exception is returned, not thrown.
*/
/*@Nullable*/ public ValidationFailure convertToSubType(/*@NotNull*/ BuiltInAtomicType subtype, boolean validate) {
if (!validate) {
setSubType(subtype);
return null;
} else if (checkRange(subtype)) {
return null;
} else {
ValidationFailure err = new ValidationFailure("String " + value +
" cannot be converted to integer subtype " + subtype.getDescription());
err.setErrorCode("FORG0001");
return err;
}
}
/**
* This class allows subtypes of xs:integer to be held, as well as xs:integer values.
* This method sets the required type label. Note that this method modifies the value in situ.
*
* @param type the subtype of integer required
* @return null if the operation succeeds, or a ValidationException if the value is out of range
*/
/*@Nullable*/ public ValidationFailure validateAgainstSubType(/*@NotNull*/ BuiltInAtomicType type) {
if (checkRange(value, type)) {
return null;
} else {
ValidationFailure err = new ValidationFailure("Value " + value +
" cannot be converted to integer subtype " + type.getDescription());
err.setErrorCode("FORG0001");
return err;
}
}
/**
* This class allows subtypes of xs:integer to be held, as well as xs:integer values.
* This method sets the required type label. It is the caller's responsibility to check that
* the value is within range.
* @param type the type label to be assigned
*/
public void setSubType(AtomicType type) {
typeLabel = type;
}
/**
* This class allows subtypes of xs:integer to be held, as well as xs:integer values.
* This method checks that the value is within range, and also sets the type label.
* @param type the subtype of integer required
* @return true if successful, false if value is out of range for the subtype
*/
public boolean checkRange(BuiltInAtomicType type) {
typeLabel = type;
return checkRange(value, type);
}
/**
* Get an object that implements XML Schema comparison semantics
*/
/*@NotNull*/ public Comparable getSchemaComparable() {
return new Int64Comparable(this);
}
/**
* A Comparable that performs comparison of an Int64Value either with another
* Int64Value or with some other representation of an XPath numeric value
*/
protected static class Int64Comparable implements Comparable {
protected Int64Value value;
public Int64Comparable(Int64Value value) {
this.value = value;
}
public long asLong() {
return value.longValue();
}
public int compareTo(/*@NotNull*/ Object o) {
if (o instanceof Int64Comparable) {
long long0 = value.longValue();
long long1 = ((Int64Comparable)o).value.longValue();
if (long0 <= long1) {
if (long0 == long1) {
return 0;
} else {
return -1;
}
} else {
return 1;
}
} else if (o instanceof BigIntegerValue.BigIntegerComparable) {
return value.asBigInteger().compareTo(((BigIntegerValue.BigIntegerComparable)o).asBigInteger());
} else if (o instanceof DecimalValue.DecimalComparable) {
return value.getDecimalValue().compareTo(((DecimalValue.DecimalComparable)o).asBigDecimal());
} else {
return SequenceTool.INDETERMINATE_ORDERING;
}
}
public boolean equals(/*@NotNull*/ Object o) {
if (o instanceof Int64Comparable) {
return (asLong() == ((Int64Comparable)o).asLong());
} else {
return compareTo(o) == 0;
}
}
public int hashCode() {
// Must align with hashCodes for other subtypes of xs:decimal
return (int)asLong();
}
}
/**
* Get the hashCode. This must conform to the rules for other NumericValue hashcodes
* @see NumericValue#hashCode
*/
public int hashCode() {
if (value > Integer.MIN_VALUE && value < Integer.MAX_VALUE) {
return (int) value;
} else {
return new Double(getDoubleValue()).hashCode();
}
}
/**
* Get the value
* @return the value of the xs:integer, as a Java long
*/
public long longValue() {
return value;
}
/**
* Return the effective boolean value of this integer
* @return false if the integer is zero, otherwise true
*/
public boolean effectiveBooleanValue() {
return value != 0;
}
/**
* Compare the value to another numeric value
* @param other the numeric value to be compared to this value
* @return -1 if this value is less than the other, 0 if they are equal,
* +1 if this value is greater
*/
public int compareTo(/*@NotNull*/ Object other) {
if (other instanceof Int64Value) {
long val2 = ((Int64Value) other).value;
if (value == val2) return 0;
if (value < val2) return -1;
return 1;
} else if (other instanceof BigIntegerValue) {
return BigInteger.valueOf(value).compareTo(((BigIntegerValue)other).asBigInteger());
} else {
return super.compareTo(other);
}
}
/**
* Compare the value to a long
* @param other the value to be compared with
* @return -1 if this is less, 0 if this is equal, +1 if this is greater or if this is NaN
*/
public int compareTo(long other) {
if (value == other) return 0;
if (value < other) return -1;
return 1;
}
/**
* Get the value as a String
*
* @return a String representation of the value
*/
public String getPrimitiveStringValue() {
return Long.toString(value);
}
/**
* Get the numeric value as a double
*
* @return A double representing this numeric value; NaN if it cannot be
* converted
*/
public double getDoubleValue() {
return (double) value;
}
/**
* Get the numeric value converted to a float
*
* @return a float representing this numeric value; NaN if it cannot be converted
*/
public float getFloatValue() {
return (float)value;
}
/**
* Get the numeric value converted to a decimal
*
* @return a decimal representing this numeric value;
*/
public BigDecimal getDecimalValue() {
return BigDecimal.valueOf(value);
}
/**
* Negate the value
*
* @return the result of inverting the sign of the value
*/
public NumericValue negate() {
if (value == Long.MIN_VALUE) {
return BigIntegerValue.makeIntegerValue(BigInteger.valueOf(value)).negate();
} else {
return new Int64Value(-value);
}
}
/**
* Implement the XPath floor() function
* @return the integer value, unchanged
*/
/*@NotNull*/ public NumericValue floor() {
return this;
}
/**
* Implement the XPath ceiling() function
* @return the integer value, unchanged
*/
/*@NotNull*/ public NumericValue ceiling() {
return this;
}
/**
* Implement the XPath round() function
* @param scale the scale (for example scale=2 rounds to 2 decimal places, scale=-2
* rounds to a multiple of 100); default value is zero which rounds to an integer
* @return the integer value, unchanged
*/
public NumericValue round(int scale) {
if (scale >= 0 || value == 0) {
return this;
} else {
if (scale < -15) {
return new BigIntegerValue(value).round(scale);
}
long absolute = Math.abs(value);
long factor = 1;
for (long i = 1; i <= -scale; i++) {
factor *= 10;
}
long modulus = absolute % factor;
long rval = absolute - modulus;
long d = modulus * 2;
if (value > 0) {
if (d >= factor) {
rval += factor;
}
} else {
if (d > factor) {
rval += factor;
}
rval = -rval;
}
return new Int64Value(rval);
}
}
/**
* Implement the XPath round-to-half-even() function
*
* @param scale number of digits required after the decimal point; the
* value -2 (for example) means round to a multiple of 100
* @return if the scale is >=0, return this value unchanged. Otherwise
* round it to a multiple of 10**-scale
*/
public NumericValue roundHalfToEven(int scale) {
if (scale >= 0) {
return this;
} else {
if (scale < -15) {
return new BigIntegerValue(value).roundHalfToEven(scale);
}
long absolute = Math.abs(value);
long factor = 1;
for (long i = 1; i <= -scale; i++) {
factor *= 10;
}
long modulus = absolute % factor;
long rval = absolute - modulus;
long d = modulus * 2;
if (d > factor) {
rval += factor;
} else if (d < factor) {
// no-op
} else {
// round to even
if (rval % (2 * factor) == 0) {
// no-op
} else {
rval += factor;
}
}
if (value < 0) rval = -rval;
return new Int64Value(rval);
}
}
/**
* Determine whether the value is negative, zero, or positive
* @return -1 if negative, 0 if zero, +1 if positive, NaN if NaN
*/
public int signum() {
if (value > 0) return +1;
if (value == 0) return 0;
return -1;
}
/**
* Get the absolute value as defined by the XPath abs() function
* @return the absolute value
*/
public NumericValue abs() {
if (value > 0) {
return this;
} else if (value == Long.MIN_VALUE) {
return new BigIntegerValue(new BigInteger("9223372036854775808"));
} else {
return makeIntegerValue(-value);
}
}
/**
* Add another integer
*/
public IntegerValue plus(/*@NotNull*/ IntegerValue other) {
// if either of the values is large, we use BigInteger arithmetic to be on the safe side
if (other instanceof Int64Value) {
long topa = (value >> 60) & 0xf;
if (topa != 0 && topa != 0xf) {
return new BigIntegerValue(value).plus(new BigIntegerValue(((Int64Value)other).value));
}
long topb = (((Int64Value)other).value >> 60) & 0xf;
if (topb != 0 && topb != 0xf) {
return new BigIntegerValue(value).plus(new BigIntegerValue(((Int64Value)other).value));
}
return makeIntegerValue(value + ((Int64Value)other).value);
} else {
return new BigIntegerValue(value).plus(other);
}
}
/**
* Subtract another integer
*/
public IntegerValue minus(/*@NotNull*/ IntegerValue other) {
// if either of the values is large, we use BigInteger arithmetic to be on the safe side
if (other instanceof Int64Value) {
long topa = (value >> 60) & 0xf;
if (topa != 0 && topa != 0xf) {
return new BigIntegerValue(value).minus(new BigIntegerValue(((Int64Value)other).value));
}
long topb = (((Int64Value)other).value >> 60) & 0xf;
if (topb != 0 && topb != 0xf) {
return new BigIntegerValue(value).minus(new BigIntegerValue(((Int64Value)other).value));
}
return makeIntegerValue(value - ((Int64Value)other).value);
} else {
return new BigIntegerValue(value).minus(other);
}
}
/**
* Multiply by another integer
*/
public IntegerValue times(/*@NotNull*/ IntegerValue other) {
// if either of the values is large, we use BigInteger arithmetic to be on the safe side
if (other instanceof Int64Value) {
if (isLong() || ((Int64Value)other).isLong()) {
return new BigIntegerValue(value).times(new BigIntegerValue(((Int64Value)other).value));
} else {
return makeIntegerValue(value * ((Int64Value)other).value);
}
} else {
return new BigIntegerValue(value).times(other);
}
}
/**
* Divide by another integer
*/
public NumericValue div(/*@NotNull*/ IntegerValue other) throws XPathException {
// if either of the values is large, we use BigInteger arithmetic to be on the safe side
if (other instanceof Int64Value) {
long quotient = ((Int64Value)other).value;
if (quotient == 0) {
throw new XPathException("Integer division by zero", "FOAR0001");
}
if (isLong() || ((Int64Value)other).isLong()) {
return new BigIntegerValue(value).div(new BigIntegerValue(quotient));
}
// the result of dividing two integers is a decimal; but if
// one divides exactly by the other, we implement it as an integer
if (value % quotient == 0) {
return makeIntegerValue(value / quotient);
} else {
return Calculator.decimalDivide(new DecimalValue(value), new DecimalValue(quotient));
}
} else {
return new BigIntegerValue(value).div(other);
}
}
/**
* Take modulo another integer
*/
public IntegerValue mod(/*@NotNull*/ IntegerValue other) throws XPathException {
// if either of the values is large, we use BigInteger arithmetic to be on the safe side
if (other instanceof Int64Value) {
long quotient = ((Int64Value) other).value;
if (quotient == 0) {
throw new XPathException("Integer modulo zero", "FOAR0001");
}
if (isLong() || ((Int64Value)other).isLong()) {
return new BigIntegerValue(value).mod(new BigIntegerValue(((Int64Value)other).value));
} else {
return makeIntegerValue(value % quotient);
}
} else {
return new BigIntegerValue(value).mod(other);
}
}
/**
* Integer divide by another integer
*/
public IntegerValue idiv(/*@NotNull*/ IntegerValue other) throws XPathException {
// if either of the values is large, we use BigInteger arithmetic to be on the safe side
if (other instanceof Int64Value) {
if (isLong() || ((Int64Value)other).isLong()) {
return new BigIntegerValue(value).idiv(new BigIntegerValue(((Int64Value)other).value));
}
try {
return makeIntegerValue(value / ((Int64Value) other).value);
} catch (ArithmeticException err) {
XPathException e;
if ("/ by zero".equals(err.getMessage())) {
e = new XPathException("Integer division by zero", "FOAR0001");
} else {
e = new XPathException("Integer division failure", err);
}
throw e;
}
} else {
return new BigIntegerValue(value).idiv(other);
}
}
/**
* Test whether this value needs a long to hold it. Specifically, whether
* the absolute value is > 2^31.
*/
private boolean isLong() {
long top = value >> 31;
return top != 0 && top != 0x1ffffffffL;
}
/**
* Get the value as a BigInteger
*/
public BigInteger asBigInteger() {
return BigInteger.valueOf(value);
}
}