diff agent/src/share/classes/sun/jvm/hotspot/types/CIntegerType.java @ 0:a61af66fc99e jdk7-b24

Initial load
author duke
date Sat, 01 Dec 2007 00:00:00 +0000
parents
children c18cbe5936b8
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/agent/src/share/classes/sun/jvm/hotspot/types/CIntegerType.java	Sat Dec 01 00:00:00 2007 +0000
@@ -0,0 +1,57 @@
+/*
+ * Copyright 2000 Sun Microsystems, Inc.  All Rights Reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
+ * CA 95054 USA or visit www.sun.com if you need additional information or
+ * have any questions.
+ *
+ */
+
+package sun.jvm.hotspot.types;
+
+import java.util.*;
+
+/** <P> This subinterface of Type provides accessors to deal with all
+    C integer types. The observation is that, according to the C
+    specification, there is no guarantee that the integer types of
+    char, short, int, and long will not all be of the same size,
+    meaning that it is incorrect to use any Java primitive type that
+    is too small to hold all of these values when talking about C
+    integer types, signed or unsigned. </P>
+
+    <P> Therefore we use long, the largest Java primitive type,
+    universally to hold C integer field values (deciding that a
+    ubiquitous change to BigInteger is not currently advantageous).
+    Routines which read C integers from fields know the fields' sizes
+    and signedness and read the appropriate number of bytes and handle
+    sign- or zero- extension for signed and unsigned types,
+    respectively. Unfortunately, since long is a signed 64-bit
+    integer, there will be problems handling C's unsigned 64-bit
+    integers, but these problems must be dealt with by the user. </P> */
+public interface CIntegerType extends Type {
+  /** Is this integer type unsigned? */
+  public boolean isUnsigned();
+
+  /** What is the maximum value of this type? Note that this will not
+      work properly for unsigned long longs. */
+  public long maxValue();
+
+  /** What is the minimum value of this type? Note that this will not
+      work properly for unsigned long longs. */
+  public long minValue();
+}