< prev index next >

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

Print this page

 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 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      * Constructor for subclasses to call.
 58      */
 59     public Number() {super();}
 60 
 61     /**
 62      * Returns the value of the specified number as an {@code int}.
 63      *
 64      * @return  the numeric value represented by this object after conversion
 65      *          to type {@code int}.
 66      */
 67     public abstract int intValue();
 68 
 69     /**
 70      * Returns the value of the specified number as a {@code long}.
 71      *
 72      * @return  the numeric value represented by this object after conversion
 73      *          to type {@code long}.
 74      */

 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 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 @jdk.internal.MigratedValueClass
 56 public abstract class Number implements java.io.Serializable {
 57     /**
 58      * Constructor for subclasses to call.
 59      */
 60     public Number() {super();}
 61 
 62     /**
 63      * Returns the value of the specified number as an {@code int}.
 64      *
 65      * @return  the numeric value represented by this object after conversion
 66      *          to type {@code int}.
 67      */
 68     public abstract int intValue();
 69 
 70     /**
 71      * Returns the value of the specified number as a {@code long}.
 72      *
 73      * @return  the numeric value represented by this object after conversion
 74      *          to type {@code long}.
 75      */
< prev index next >