annotate agent/src/share/classes/sun/jvm/hotspot/types/CIntegerType.java @ 1552:c18cbe5936b8

6941466: Oracle rebranding changes for Hotspot repositories Summary: Change all the Sun copyrights to Oracle copyright Reviewed-by: ohair
author trims
date Thu, 27 May 2010 19:08:38 -0700
parents a61af66fc99e
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
a61af66fc99e Initial load
duke
parents:
diff changeset
1 /*
1552
c18cbe5936b8 6941466: Oracle rebranding changes for Hotspot repositories
trims
parents: 0
diff changeset
2 * Copyright (c) 2000, Oracle and/or its affiliates. All rights reserved.
0
a61af66fc99e Initial load
duke
parents:
diff changeset
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
a61af66fc99e Initial load
duke
parents:
diff changeset
4 *
a61af66fc99e Initial load
duke
parents:
diff changeset
5 * This code is free software; you can redistribute it and/or modify it
a61af66fc99e Initial load
duke
parents:
diff changeset
6 * under the terms of the GNU General Public License version 2 only, as
a61af66fc99e Initial load
duke
parents:
diff changeset
7 * published by the Free Software Foundation.
a61af66fc99e Initial load
duke
parents:
diff changeset
8 *
a61af66fc99e Initial load
duke
parents:
diff changeset
9 * This code is distributed in the hope that it will be useful, but WITHOUT
a61af66fc99e Initial load
duke
parents:
diff changeset
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
a61af66fc99e Initial load
duke
parents:
diff changeset
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
a61af66fc99e Initial load
duke
parents:
diff changeset
12 * version 2 for more details (a copy is included in the LICENSE file that
a61af66fc99e Initial load
duke
parents:
diff changeset
13 * accompanied this code).
a61af66fc99e Initial load
duke
parents:
diff changeset
14 *
a61af66fc99e Initial load
duke
parents:
diff changeset
15 * You should have received a copy of the GNU General Public License version
a61af66fc99e Initial load
duke
parents:
diff changeset
16 * 2 along with this work; if not, write to the Free Software Foundation,
a61af66fc99e Initial load
duke
parents:
diff changeset
17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
a61af66fc99e Initial load
duke
parents:
diff changeset
18 *
1552
c18cbe5936b8 6941466: Oracle rebranding changes for Hotspot repositories
trims
parents: 0
diff changeset
19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
c18cbe5936b8 6941466: Oracle rebranding changes for Hotspot repositories
trims
parents: 0
diff changeset
20 * or visit www.oracle.com if you need additional information or have any
c18cbe5936b8 6941466: Oracle rebranding changes for Hotspot repositories
trims
parents: 0
diff changeset
21 * questions.
0
a61af66fc99e Initial load
duke
parents:
diff changeset
22 *
a61af66fc99e Initial load
duke
parents:
diff changeset
23 */
a61af66fc99e Initial load
duke
parents:
diff changeset
24
a61af66fc99e Initial load
duke
parents:
diff changeset
25 package sun.jvm.hotspot.types;
a61af66fc99e Initial load
duke
parents:
diff changeset
26
a61af66fc99e Initial load
duke
parents:
diff changeset
27 import java.util.*;
a61af66fc99e Initial load
duke
parents:
diff changeset
28
a61af66fc99e Initial load
duke
parents:
diff changeset
29 /** <P> This subinterface of Type provides accessors to deal with all
a61af66fc99e Initial load
duke
parents:
diff changeset
30 C integer types. The observation is that, according to the C
a61af66fc99e Initial load
duke
parents:
diff changeset
31 specification, there is no guarantee that the integer types of
a61af66fc99e Initial load
duke
parents:
diff changeset
32 char, short, int, and long will not all be of the same size,
a61af66fc99e Initial load
duke
parents:
diff changeset
33 meaning that it is incorrect to use any Java primitive type that
a61af66fc99e Initial load
duke
parents:
diff changeset
34 is too small to hold all of these values when talking about C
a61af66fc99e Initial load
duke
parents:
diff changeset
35 integer types, signed or unsigned. </P>
a61af66fc99e Initial load
duke
parents:
diff changeset
36
a61af66fc99e Initial load
duke
parents:
diff changeset
37 <P> Therefore we use long, the largest Java primitive type,
a61af66fc99e Initial load
duke
parents:
diff changeset
38 universally to hold C integer field values (deciding that a
a61af66fc99e Initial load
duke
parents:
diff changeset
39 ubiquitous change to BigInteger is not currently advantageous).
a61af66fc99e Initial load
duke
parents:
diff changeset
40 Routines which read C integers from fields know the fields' sizes
a61af66fc99e Initial load
duke
parents:
diff changeset
41 and signedness and read the appropriate number of bytes and handle
a61af66fc99e Initial load
duke
parents:
diff changeset
42 sign- or zero- extension for signed and unsigned types,
a61af66fc99e Initial load
duke
parents:
diff changeset
43 respectively. Unfortunately, since long is a signed 64-bit
a61af66fc99e Initial load
duke
parents:
diff changeset
44 integer, there will be problems handling C's unsigned 64-bit
a61af66fc99e Initial load
duke
parents:
diff changeset
45 integers, but these problems must be dealt with by the user. </P> */
a61af66fc99e Initial load
duke
parents:
diff changeset
46 public interface CIntegerType extends Type {
a61af66fc99e Initial load
duke
parents:
diff changeset
47 /** Is this integer type unsigned? */
a61af66fc99e Initial load
duke
parents:
diff changeset
48 public boolean isUnsigned();
a61af66fc99e Initial load
duke
parents:
diff changeset
49
a61af66fc99e Initial load
duke
parents:
diff changeset
50 /** What is the maximum value of this type? Note that this will not
a61af66fc99e Initial load
duke
parents:
diff changeset
51 work properly for unsigned long longs. */
a61af66fc99e Initial load
duke
parents:
diff changeset
52 public long maxValue();
a61af66fc99e Initial load
duke
parents:
diff changeset
53
a61af66fc99e Initial load
duke
parents:
diff changeset
54 /** What is the minimum value of this type? Note that this will not
a61af66fc99e Initial load
duke
parents:
diff changeset
55 work properly for unsigned long longs. */
a61af66fc99e Initial load
duke
parents:
diff changeset
56 public long minValue();
a61af66fc99e Initial load
duke
parents:
diff changeset
57 }