libjava/classpath/vm/reference/java/lang/VMFloat.java

   1 /* VMFloat.java -- VM Specific Float methods
   2    Copyright (C) 2003, 2010  Free Software Foundation, Inc.
   3
   4 This file is part of GNU Classpath.
   5
   6 GNU Classpath is free software; you can redistribute it and/or modify
   7 it under the terms of the GNU General Public License as published by
   8 the Free Software Foundation; either version 2, or (at your option)
   9 any later version.
  10
  11 GNU Classpath is distributed in the hope that it will be useful, but
  12 WITHOUT ANY WARRANTY; without even the implied warranty of
  13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14 General Public License for more details.
  15
  16 You should have received a copy of the GNU General Public License
  17 along with GNU Classpath; see the file COPYING.  If not, write to the
  18 Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
  19 02110-1301 USA.
  20
  21 Linking this library statically or dynamically with other modules is
  22 making a combined work based on this library.  Thus, the terms and
  23 conditions of the GNU General Public License cover the whole
  24 combination.
  25
  26 As a special exception, the copyright holders of this library give you
  27 permission to link this library with independent modules to produce an
  28 executable, regardless of the license terms of these independent
  29 modules, and to copy and distribute the resulting executable under
  30 terms of your choice, provided that you also meet, for each linked
  31 independent module, the terms and conditions of the license of that
  32 module.  An independent module is a module which is not derived from
  33 or based on this library.  If you modify this library, you may extend
  34 this exception to your version of the library, but you are not
  35 obligated to do so.  If you do not wish to do so, delete this
  36 exception statement from your version. */
  37
  38 package java.lang;
  39
  40 import gnu.classpath.Configuration;
  41
  42 /*
  43  * This class is a reference version, mainly for compiling a class library
  44  * jar.  It is likely that VM implementers replace this with their own
  45  * version that can communicate effectively with the VM.
  46  */
  47
  48 /**
  49  * Code relocated from java.lang.Float by
  50  * @author Dave Grove <groved@us.ibm.com>
  51  */
  52 final class VMFloat
  53 {
  54
  55   /**
  56    * Load native routines necessary for this class.
  57    */
  58   static
  59   {
  60     if (Configuration.INIT_LOAD_LIBRARY)
  61       {
  62         System.loadLibrary("javalang");
  63       }
  64   }
  65
  66   private VMFloat() {} // Prohibits instantiation.
  67
  68   /**
  69    * Convert the float to the IEEE 754 floating-point "single format" bit
  70    * layout. Bit 31 (the most significant) is the sign bit, bits 30-23
  71    * (masked by 0x7f800000) represent the exponent, and bits 22-0
  72    * (masked by 0x007fffff) are the mantissa. This function leaves NaN alone,
  73    * rather than collapsing to a canonical value. The result of this function
  74    * can be used as the argument to <code>Float.intBitsToFloat(int)</code> to
  75    * obtain the original <code>float</code> value.
  76    *
  77    * @param value the <code>float</code> to convert
  78    * @return the bits of the <code>float</code>
  79    * @see #intBitsToFloat(int)
  80    */
  81   static native int floatToRawIntBits(float value);
  82
  83   /**
  84    * Convert the argument in IEEE 754 floating-point "single format" bit
  85    * layout to the corresponding float. Bit 31 (the most significant) is the
  86    * sign bit, bits 30-23 (masked by 0x7f800000) represent the exponent, and
  87    * bits 22-0 (masked by 0x007fffff) are the mantissa. This function leaves
  88    * NaN alone, so that you can recover the bit pattern with
  89    * <code>Float.floatToRawIntBits(float)</code>.
  90    *
  91    * @param bits the bits to convert
  92    * @return the <code>float</code> represented by the bits
  93    * @see #floatToIntBits(float)
  94    * @see #floatToRawIntBits(float)
  95    */
  96   static native float intBitsToFloat(int bits);
  97
  98   /**
  99    * @param f the <code>float</code> to convert
 100    * @return the <code>String</code> representing the <code>float</code>
 101    */
 102   static String toString(float f)
 103   {
 104     return VMDouble.toString(f, true);
 105   }
 106
 107   /**
 108    * @param str the <code>String</code> to convert
 109    * @return the <code>float</code> value of <code>s</code>
 110    * @throws NumberFormatException if <code>str</code> cannot be parsed as a
 111    *         <code>float</code>
 112    * @throws NullPointerException if <code>str</code> is null
 113    */
 114   static float parseFloat(String str)
 115   {
 116     // XXX Rounding parseDouble() causes some errors greater than 1 ulp from
 117     // the infinitely precise decimal.
 118     return (float) Double.parseDouble(str);
 119   }
 120 } // class VMFloat