gov.sandia.cognition.math.MutableLong Maven / Gradle / Ivy

Go to download
/*
 * File:                MutableLong.java
 * Authors:             Justin Basilico
 * Company:             Sandia National Laboratories
 * Project:             Cognitive Foundry
 * 
 * Copyright June 14, 2011, Sandia Corporation.
 * Under the terms of Contract DE-AC04-94AL85000, there is a non-exclusive
 * license for use of this work by or on behalf of the U.S. Government. Export
 * of this program may require a license from the United States Government.
 * See CopyrightHistory.txt for complete details.
 * 
 */

package gov.sandia.cognition.math;

import gov.sandia.cognition.math.matrix.Vector;
import gov.sandia.cognition.math.matrix.Vectorizable;
import gov.sandia.cognition.math.matrix.mtj.Vector1;
import gov.sandia.cognition.util.CloneableSerializable;

/**
 * A mutable object containing a long. It is meant to be used for cases where
 * you may want to use a java.lang.Long but its value will be updated
 * frequently, such as in a map or other data structure. Many of the
 * implementations of the methods in this class are based on the behavior
 * described in java.lang.Long.
 *
 * @author  Justin Basilico
 * @since   3.3.0
 */
public class MutableLong
    extends Number
    implements CloneableSerializable, Comparable,
        EuclideanRing, Vectorizable
{
    /** Serial version ID for the class. */
    private static final long serialVersionUID = 20110602L;

    /** The value. Note: This is public just for performance reasons when
     *  people don't want to do the getter/setter for overhead reasons. */
    public long value;

    /**
     * Creates an {@code MutableLong} with an initial value of zero.
     */
    public MutableLong()
    {
        this(0);
    }

    /**
     * Creates an {@code MutableLong} with the given value.
     *
     * @param   value
     *      The value to store in the object.
     */
    public MutableLong(
        final long value)
    {
        super();

        this.value = value;
    }

    /**
     * Creates a copy of a {@code MutableLong}.
     *
     * @param   other
     *      The other value.
     */
    public MutableLong(
        final MutableLong other)
    {
        this(other.value);
    }

    @Override
    public MutableLong clone()
    {
        try
        {
            return (MutableLong) super.clone();
        }
        catch (CloneNotSupportedException ex)
        {
            throw new RuntimeException(ex);
        }
    }

    @Override
    public boolean equals(
        final Object other)
    {
        return other == this
            || (other instanceof MutableLong
                && this.equals((MutableLong) other));
    }

    /**
     * Determines if this MutableLong is equal to another MutableLong.
     * Provides a convenience for not casting.
     *
     * @param   other
     *      The other value.
     * @return
     *      True if the two values are equal and false otherwise.
     */
    public boolean equals(
        final MutableLong other)
    {
        return this.equals(other.value);
    }

    /**
     * Determines if this MutableLong's value is equal to a given long.
     *
     * @param   other
     *      A long.
     * @return
     *      True if the two values are equal and false otherwise.
     */
    public boolean equals(
        final long other)
    {
        return this.value == other;
    }

    @Override
    public int compareTo(
        final MutableLong other)
    {
        if (this.value < other.value)
        {
            return -1;
        }
        else if (this.value == other.value)
        {
            return 0;
        }
        else
        {
            return +1;
        }
    }

    @Override
    public int hashCode()
    {
        // This is the recommended way to generate a HashCode for a Long.
        return (int) (this.value ^ (this.value >>> 32));
    }

    @Override
    public int intValue()
    {
        return (int) this.value;
    }

    @Override
    public long longValue()
    {
        return this.value;
    }

    @Override
    public float floatValue()
    {
        return (float) this.value;
    }

    @Override
    public double doubleValue()
    {
        return (double) this.value;
    }

    /**
     * Gets the value stored in the object.
     *
     * @return
     *      The value.
     */
    public long getValue()
    {
        return this.value;
    }

    /**
     * Sets the value stored in the object.
     *
     * @param   value
     *      The value.
     */
    public void setValue(
        final long value)
    {
        this.value = value;
    }

    @Override
    public String toString()
    {
        return "" + this.value;
    }

    @Override
    public boolean equals(
        final MutableLong other,
        final double effectiveZero)
    {
        return Math.abs(this.value - other.value) <= effectiveZero;
    }

    @Override
    public MutableLong plus(
        final MutableLong other)
    {
        return new MutableLong(this.value + other.value);
    }

    @Override
    public void plusEquals(
        final MutableLong other)
    {
        this.value += other.value;
    }

    @Override
    public MutableLong minus(
        final MutableLong other)
    {
        return new MutableLong(this.value - other.value);
    }

    @Override
    public void minusEquals(
        final MutableLong other)
    {
        this.value -= other.value;
    }

    @Override
    public MutableLong times(
        final MutableLong other)
    {
        return new MutableLong(this.value * other.value);
    }

    @Override
    public void timesEquals(
        final MutableLong other)
    {
        this.value *= other.value;
    }

    @Override
    public MutableLong divide(
        final MutableLong other)
    {
        return new MutableLong(this.value / other.value);
    }

    @Override
    public void divideEquals(
        final MutableLong other)
    {
        this.value /= other.value;
    }

    @Override
    public MutableLong dotTimes(
        final MutableLong other)
    {
        return new MutableLong(this.value * other.value);
    }

    @Override
    public void dotTimesEquals(
        final MutableLong other)
    {
        this.value *= other.value;
    }

    @Override
    public MutableLong scale(
        final double scaleFactor)
    {
        return new MutableLong((long) (this.value * scaleFactor));
    }

    @Override
    public void scaleEquals(
        final double scaleFactor)
    {
        this.value *= scaleFactor;
    }

    @Override
    public MutableLong scaledPlus(
        final double scaleFactor,
        final MutableLong other)
    {
        return new MutableLong(this.value + (long) (scaleFactor * other.value));
    }

    @Override
    public void scaledPlusEquals(
        final double scaleFactor,
        final MutableLong other)
    {
        this.value += scaleFactor * other.value;
    }

    @Override
    public MutableLong scaledMinus(
        final double scaleFactor,
        final MutableLong other)
    {
        return new MutableLong(this.value - (long) (scaleFactor * other.value));
    }

    @Override
    public void scaledMinusEquals(
        final double scaleFactor,
        final MutableLong other)
    {
        this.value -= scaleFactor * other.value;
    }


    @Override
    public MutableLong negative()
    {
        return new MutableLong(-this.value);
    }

    @Override
    public void negativeEquals()
    {
        this.value = -this.value;
    }

    @Override
    public void zero()
    {
        this.value = 0;
    }

    @Override
    public boolean isZero()
    {
        return this.value == 0;
    }

    @Override
    public boolean isZero(
        final double effectiveZero)
    {
        return Math.abs(this.value) <= effectiveZero;
    }

    @Override
    public Vector1 convertToVector()
    {
        return new Vector1(this.value);
    }

    @Override
    public void convertFromVector(
        final Vector parameters)
    {
        parameters.assertDimensionalityEquals(1);
        this.value = (long) parameters.getElement(0);
    }
}