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 */
|