< prev index next >

src/java.base/share/classes/java/lang/Number.java

Print this page




  31  * primitive types {@code byte}, {@code double}, {@code float}, {@code
  32  * int}, {@code long}, and {@code short}.
  33  *
  34  * The specific semantics of the conversion from the numeric value of
  35  * a particular {@code Number} implementation to a given primitive
  36  * type is defined by the {@code Number} implementation in question.
  37  *
  38  * For platform classes, the conversion is often analogous to a
  39  * narrowing primitive conversion or a widening primitive conversion
  40  * as defined in <cite>The Java&trade; Language Specification</cite>
  41  * for converting between primitive types.  Therefore, conversions may
  42  * lose information about the overall magnitude of a numeric value, may
  43  * lose precision, and may even return a result of a different sign
  44  * than the input.
  45  *
  46  * See the documentation of a given {@code Number} implementation for
  47  * conversion details.
  48  *
  49  * @author      Lee Boynton
  50  * @author      Arthur van Hoff
  51  * @jls 5.1.2 Widening Primitive Conversions
  52  * @jls 5.1.3 Narrowing Primitive Conversions
  53  * @since   1.0
  54  */
  55 public abstract class Number implements java.io.Serializable {
  56     /**
  57      * Returns the value of the specified number as an {@code int}.
  58      *
  59      * @return  the numeric value represented by this object after conversion
  60      *          to type {@code int}.
  61      */
  62     public abstract int intValue();
  63 
  64     /**
  65      * Returns the value of the specified number as a {@code long}.
  66      *
  67      * @return  the numeric value represented by this object after conversion
  68      *          to type {@code long}.
  69      */
  70     public abstract long longValue();
  71 
  72     /**




  31  * primitive types {@code byte}, {@code double}, {@code float}, {@code
  32  * int}, {@code long}, and {@code short}.
  33  *
  34  * The specific semantics of the conversion from the numeric value of
  35  * a particular {@code Number} implementation to a given primitive
  36  * type is defined by the {@code Number} implementation in question.
  37  *
  38  * For platform classes, the conversion is often analogous to a
  39  * narrowing primitive conversion or a widening primitive conversion
  40  * as defined in <cite>The Java&trade; Language Specification</cite>
  41  * for converting between primitive types.  Therefore, conversions may
  42  * lose information about the overall magnitude of a numeric value, may
  43  * lose precision, and may even return a result of a different sign
  44  * than the input.
  45  *
  46  * See the documentation of a given {@code Number} implementation for
  47  * conversion details.
  48  *
  49  * @author      Lee Boynton
  50  * @author      Arthur van Hoff
  51  * @jls 5.1.2 Widening Primitive Conversion
  52  * @jls 5.1.3 Narrowing Primitive Conversion
  53  * @since   1.0
  54  */
  55 public abstract class Number implements java.io.Serializable {
  56     /**
  57      * Returns the value of the specified number as an {@code int}.
  58      *
  59      * @return  the numeric value represented by this object after conversion
  60      *          to type {@code int}.
  61      */
  62     public abstract int intValue();
  63 
  64     /**
  65      * Returns the value of the specified number as a {@code long}.
  66      *
  67      * @return  the numeric value represented by this object after conversion
  68      *          to type {@code long}.
  69      */
  70     public abstract long longValue();
  71 
  72     /**


< prev index next >