some small changes delting unneeded imports. two new exceptions in mir.storage. usage...
[mir.git] / source / mir / misc / NumberUtils.java
1 /*
2  * Copyright (C) 2001, 2002  The Mir-coders group
3  *
4  * This file is part of Mir.
5  *
6  * Mir 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 of the License, or
9  * (at your option) any later version.
10  *
11  * Mir is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with Mir; if not, write to the Free Software
18  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
19  *
20  * In addition, as a special exception, The Mir-coders gives permission to link
21  * the code of this program with the com.oreilly.servlet library, any library
22  * licensed under the Apache Software License, The Sun (tm) Java Advanced
23  * Imaging library (JAI), The Sun JIMI library (or with modified versions of
24  * the above that use the same license as the above), and distribute linked
25  * combinations including the two.  You must obey the GNU General Public
26  * License in all respects for all of the code used other than the above
27  * mentioned libraries.  If you modify this file, you may extend this exception
28  * to your version of the file, but you are not obligated to do so.  If you do
29  * not wish to do so, delete this exception statement from your version.
30  */
31
32 package  mir.misc;
33
34 import java.text.NumberFormat;
35
36 /**
37  * Help methods for number handling.
38  *
39  * @version $Id: NumberUtils.java,v 1.4 2003/01/25 17:45:18 idfx Exp $
40  * @author mh, Mir-coders group
41  *
42  */
43
44 public final class NumberUtils {
45
46   /* 
47    * Uses a suffix indicating multiples of 1024 (K), 
48    * 1024*1024 (M), and 1024*1024*1024 (G).  For example, 
49    * 8500 would be converted to 8.3K, 133456345 to 
50    * 127M, 56990456345 to 53G, and so on.  Numbers 
51    * smaller than 1024 aren't modified.
52    *
53    * @param bytes The number of bytes.
54    * @return A text representation of the number of bytes,
55    *     abbreviated for larger quantities.
56    */
57   public static String humanReadableSize(double bytes)
58   {
59     String suffix;
60       
61     if( bytes >= 1024 * 1024 * 1024 )
62     {
63       bytes /= (1024 * 1024 * 1024);
64       suffix = "G";
65     }
66     else if( bytes >= 1024 * 1024 )
67     {
68       bytes /= (1024 * 1024);
69       suffix = "M";
70     }
71     else if( bytes >= 1024 )
72     {
73       bytes /= 1024;
74       suffix = "K";
75     }
76     else
77     {
78       suffix = "";
79     }
80     int frac = (bytes >= 10  ||  bytes == 0)  ?  0  :  1;
81     NumberFormat nf = NumberFormat.getInstance();
82     nf.setMinimumFractionDigits(frac);
83     nf.setMaximumFractionDigits(frac);
84     nf.setGroupingUsed(false);
85     return nf.format(bytes) + suffix;
86   }
87
88 }
89