/*\
* Copyright 2006 Klaus Rogall, Hamburg, Germany (klaus.rogall@web.de). All rights reserved.
* _____________________________________________________________________________________________________________________
*
* This class is "Open Source" as defined by the Open Source Initiative (OSI). You can redistribute it and/or modify it
* under the terms of the BSD License. The license text is appended to the end of this file.
\*/
package de.klaro.base.util;
import java.math.BigDecimal;
/**
* Methods zur Zahlen-Manipulation und Zahlen-Verarbeitung.
*/
public class Numbers extends Object
{
/* ______________________________________________________________________________________________________________ *\
\* Konstanten */
/* ______________________________________________________________________________________________________________ *\
\* Klassenvariablen */
/* ______________________________________________________________________________________________________________ *\
\* Instanzvariablen */
/* ______________________________________________________________________________________________________________ *\
\* Konstruktoren */
/**
* Erzeugt eine Instanz dieser Klasse.
*
* Da verhindert werden soll, dass Instanzen dieser Klasse ausserhalb dieser Klasse erzeugt werdem, ist dieser
* Konstruktor 'private' deklariert.
*/
private Numbers()
{
super();
}
/* ______________________________________________________________________________________________________________ *\
\* Instanzmethoden */
/* ______________________________________________________________________________________________________________ *\
\* Klassenmethoden */
/**
* Liefert eine Float-Dezimalzahl kaufmnnisch gerundet zurck.
*
* @param value Die Dezimalzahl
* @param scale Die Anzahl der Nachkommastellen
* @return Der kaufmnnisch gerundete Wert
*/
public static float round(float value,int scale)
{
return (Float.isInfinite(value) || Float.isNaN(value))? value: new BigDecimal(value).setScale(scale,BigDecimal.ROUND_HALF_UP).floatValue();
}
/**
* Liefert eine Double-Dezimalzahl kaufmnnisch gerundet zurck.
*
* @param value Die Dezimalzahl
* @param scale Die Anzahl der Nachkommastellen
* @return Der kaufmnnisch gerundete Wert
*/
public static double round(double value,int scale)
{
return (Double.isInfinite(value) || Double.isNaN(value))? value: new BigDecimal(value).setScale(scale,BigDecimal.ROUND_HALF_UP).doubleValue();
}
/**
* Liefert eine Float-Dezimalzahl kaufmnnisch gerundet als Ganzzahl zurck.
*
* @param value Die Dezimalzahl
* @return Der kaufmnnisch gerundete Wert
*/
public static int round(float value)
{
return (Float.isInfinite(value) || Float.isNaN(value))? 0: new BigDecimal(value).setScale(0,BigDecimal.ROUND_HALF_UP).intValue();
}
/**
* Liefert eine Double-Dezimalzahl kaufmnnisch gerundet als Ganzzahl zurck.
*
* @param value Die Dezimalzahl
* @return Der kaufmnnisch gerundete Wert
*/
public static int round(double value)
{
return (Double.isInfinite(value) || Double.isNaN(value))? 0: new BigDecimal(value).setScale(0,BigDecimal.ROUND_HALF_UP).intValue();
}
/**
* Wandelt einen String in eine Short-Zahl um.
*
* @param string Der String
* @param defaultValue Der Default-Wert, der geliefert wird, wenn die Umwandlung fehlschlgt
* @return Der String als Short-Ganzzahl
*/
public static short parse(CharSequence string,short defaultValue)
{
Short result = parseShort(string);
return (result == null)? defaultValue: result;
}
/**
* Wandelt einen String in eine Integer-Zahl um.
*
* @param string Der String
* @param defaultValue Der Default-Wert, der geliefert wird, wenn die Umwandlung fehlschlgt
* @return Der String als Integer-Ganzzahl
*/
public static int parse(CharSequence string,int defaultValue)
{
Integer result = parseInteger(string);
return (result == null)? defaultValue: result;
}
/**
* Wandelt einen String in eine Long-Zahl um.
*
* @param string Der String
* @param defaultValue Der Default-Wert, der geliefert wird, wenn die Umwandlung fehlschlgt
* @return Der String als Long-Ganzzahl
*/
public static long parse(CharSequence string,long defaultValue)
{
Long result = parseLong(string);
return (result == null)? defaultValue: result;
}
/**
* Wandelt einen String in eine Float-Zahl um.
*
* @param string Der String
* @param defaultValue Der Default-Wert, der geliefert wird, wenn die Umwandlung fehlschlgt
* @return Der String als Float-Dezimalzahl
*/
public static float parse(CharSequence string,float defaultValue)
{
Float result = parseFloat(string);
return (result == null)? defaultValue: result;
}
/**
* Wandelt einen String in eine Double-Zahl um.
*
* @param string Der String
* @param defaultValue Der Default-Wert, der geliefert wird, wenn die Umwandlung fehlschlgt
* @return Der String als Double-Dezimalzahl
*/
public static double parse(CharSequence string,double defaultValue)
{
Double result = parseDouble(string);
return (result == null)? defaultValue: result;
}
/**
* Wandelt einen String in eine BigDecimal-Zahl um.
*
* @param string Der String
* @param defaultValue Der Default-Wert, der geliefert wird, wenn die Umwandlung fehlschlgt
* @return Der String als Double-Dezimalzahl
*/
public static BigDecimal parse(CharSequence string,BigDecimal defaultValue)
{
BigDecimal result = parseBigDecimal(string);
return (result == null)? defaultValue: result;
}
/**
* Wandelt einen String in eine Short-Zahl um.
*
* @param string Der String
* @return Der String als Short-Ganzzahl, oder 'null' wenn die Umwandlung fehlschlgt
*/
public static Short parseShort(CharSequence string)
{
if (string == null)
{
return null;
}
try
{
return Short.parseShort(string.toString());
}
catch (NumberFormatException e)
{
return null;
}
}
/**
* Wandelt einen String in eine Integer-Zahl um.
*
* @param string Der String
* @return Der String als Integer-Ganzzahl, oder 'null' wenn die Umwandlung fehlschlgt
*/
public static Integer parseInteger(CharSequence string)
{
if (string == null)
{
return null;
}
try
{
return Integer.parseInt(string.toString());
}
catch (NumberFormatException e)
{
return null;
}
}
/**
* Wandelt einen String in eine Long-Zahl um.
*
* @param string Der String
* @return Der String als Long-Ganzzahl, oder 'null' wenn die Umwandlung fehlschlgt
*/
public static Long parseLong(CharSequence string)
{
if (string == null)
{
return null;
}
try
{
return Long.parseLong(string.toString());
}
catch (NumberFormatException e)
{
return null;
}
}
/**
* Wandelt einen String in eine Float-Zahl um.
*
* @param string Der String
* @return Der String als Float-Ganzzahl, oder 'null' wenn die Umwandlung fehlschlgt
*/
public static Float parseFloat(CharSequence string)
{
if (string == null)
{
return null;
}
try
{
return Float.parseFloat(string.toString());
}
catch (NumberFormatException e)
{
return null;
}
}
/**
* Wandelt einen String in eine Double-Zahl um.
*
* @param string Der String
* @return Der String als Double-Ganzzahl, oder 'null' wenn die Umwandlung fehlschlgt
*/
public static Double parseDouble(CharSequence string)
{
if (string == null)
{
return null;
}
try
{
return Double.parseDouble(string.toString());
}
catch (NumberFormatException e)
{
return null;
}
}
/**
* Wandelt einen String in eine BigDecimal-Zahl um.
*
* @param string Der String
* @return Der String als BigDecimal-Ganzzahl, oder 'null' wenn die Umwandlung fehlschlgt
*/
public static BigDecimal parseBigDecimal(CharSequence string)
{
if (string == null)
{
return null;
}
try
{
return new BigDecimal(string.toString());
}
catch (NumberFormatException e)
{
return null;
}
}
/* ______________________________________________________________________________________________________________ *\
\* Klassen */
}
/*\
* _____________________________________________________________________________________________________________________
*
* This software is distributed under the terms of the BSD License:
*
* Copyright 2006 Klaus Rogall, Hamburg, Germany (klaus.rogall@web.de). All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification, are permitted provided that the
* following conditions are met:
*
* - Redistributions of source code must retain the above copyright notice, this list of conditions and the following
* disclaimer.
* - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following
* disclaimer in the documentation and/or other materials provided with the distribution.
* - Neither the name of the Klaus Rogall nor the names of its contributors may be used to endorse or promote products
* derived from this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
* INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
* _____________________________________________________________________________________________________________________
\*/
