ParseUtils (XDEV Application Framework 6.0.1 API)

java.lang.Object
- xdev.util.ParseUtils

```
public class ParseUtils
extends Object
```
The ParseUtils class provides parsing methods for various types.

Since:

2.0

Author:

XDEV Software

Method Summary

All Methods Static Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`static Object`	`castTo(Object value, Class type)` Checks whether `Object` `value` is a type of `Class` `type`.
`static String`	`format(double d)` Formats the `double` `d` with the actual language setting and returns it as `String`.
`static String`	`format(double d, String pattern)` Formates the number `l` to a `String` with the help of the `format`.
`static String`	`format(long l)` Formats the `long` `l` with the actual language setting and returns it as `String`.
`static String`	`format(long l, String pattern)` Formates the number `l` to a `String` with the help of the `format`.
`static String`	`formatAsCurrency(double d)` Formates the `double` `d` as currency with the actual language setting and returns it as `String`.
`static String`	`formatAsCurrency(long l)` Formates the `long` `l` as currency with the actual language setting and returns it as `String`.
`static boolean`	`isAlphaNumeric(String value, int min, int max)` Checks if the variable `String` is not a number and is it has a length between `minLen` and `maxLen`.
`static boolean`	`isBoolean(Object value)` Checks if the variable `value` is type of `boolean` .
`static boolean`	`isDecimal(Object value)` Checks if the `Object` `value` is a decimal or can parsed to.
`static boolean`	`isEmail(String value)` Checks if the variable `String` is a valid Email address.
`static boolean`	`isInteger(Object value)` Checks if the `Object` `value` is an integer.
`static boolean`	`isLong(Object value)` Checks if the `Object` `value` is an integer.
`static boolean`	`isNumeric(Object value, double min, double max)` * Checks if the variable `value` is a value between `min` and `max`.
`static boolean`	`isNumeric(Object value, long min, long max)` Checks if the variable `value` is a value between `min` and `max`.
`static boolean`	`isType(Object value, Class type)` Checks whether `Object` `value` is a type of `Class` `type`.
`static boolean`	`isType(Object value, String className)` Checks whether `Object` `value` is a type of `Class` `className`.
`static Number`	`parse(Object value)` Parse the variable `value` to an `Number` .
`static Number`	`parse(Object value, String pattern)` Parse the variable `value` to an `Number` with the help of of the `format`.
`static boolean`	`parseBoolean(Object value)` Deprecated. use `ConversionUtils.toboolean(Object)`
`static byte`	`parseByte(Object value)` Deprecated. use `ConversionUtils.tobyte(Object)`
`static byte`	`parseByte(Object value, String pattern)` Parse the variable `value` to a `byte` with the help of of the `format`.
`static XdevDate`	`parseDate(Object value)` Deprecated. use `ConversionUtils.toXdevDate(Object)`
`static XdevDate`	`parseDate(Object value, String pattern)` Ckecks whether `Object` `value` is a `XdevDate`.
`static double`	`parseDouble(Object value)` Deprecated. use `ConversionUtils.todouble(Object)`
`static double`	`parseDouble(Object value, String pattern)` Parse the variable `value` to a `double` with the help of of the `format`.
`static double`	`parseDoubleAsCurrency(Object value)` Parse the variable `value` to an `double`.
`static double`	`parseDoubleAsCurrency(Object value, String pattern)` Parse the variable `value` to a `double` with the help of of the `format`.
`static XdevFile`	`parseFile(Object value)` Deprecated. use `ConversionUtils.toXdevFile(Object)`
`static float`	`parseFloat(Object value)` Deprecated. use `ConversionUtils.tofloat(Object)`
`static float`	`parseFloat(Object value, String pattern)` Parse the variable `value` to a `float` with the help of of the `format`.
`static XdevHashtable`	`parseHashtable(Object value)` Deprecated. use `ConversionUtils.toXdevHashtable(Object)`
`static XdevImage`	`parseImage(Object value)` Deprecated. use `ConversionUtils.toXdevImage(Object)`
`static int`	`parseInt(Object value)` Deprecated. use `ConversionUtils.toint(Object)`
`static int`	`parseInt(Object value, String pattern)` Parse the variable `value` to a `int` with the help of of the `format`.
`static XdevList`	`parseList(Object value)` Deprecated. use `ConversionUtils.toXdevList(Object)`
`static long`	`parseLong(Object value)` Deprecated. use `ConversionUtils.tolong(Object)`
`static long`	`parseLong(Object value, String pattern)` Parse the variable `value` to a `long` with the help of of the `format`.
`static short`	`parseShort(Object value)` Deprecated. use `ConversionUtils.toshort(Object)`
`static short`	`parseShort(Object value, String pattern)` Parse the variable `value` to a `short` with the help of of the `format`.
`static Date`	`parseUtilDate(Object value)` Deprecated. use `ConversionUtils.toDate(Object)`
`static String`	`toBinaryString(int i)` Parse the variable `i` to `BinaryString`.
`static String`	`toBinaryString(long l)` Parse the variable `l` to `BinaryString`.
`static String`	`toHexString(int i)` Parse the variable `i` to `HexString`.
`static String`	`toHexString(long l)` Parse the variable `l` to `HexString`.
`static String`	`toOctalString(int i)` Parse the variable `i` to `OctalString`.
`static String`	`toOctalString(long l)` Parse the variable `l` to `OctalString`.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

parseByte
```
@Deprecated
public static byte parseByte(Object value)
                                  throws NumberFormatException
```
Deprecated. use ConversionUtils.tobyte(Object)
Parse the variable value to a byte .
```
 ParseUtils.parseByte(7895);     returns -44
 ParseUtils.parseByte(-64568);   returns -56
 
```
Parameters:

value - the value which will be parsed to byte

Returns:

the byte parsed from the value, if possible.

Throws:

NumberFormatException - if value could not be parsed to byte

See Also:

parseByte(Object, String), parseDouble(Object)

parseByte
```
public static byte parseByte(Object value,
                             String pattern)
                      throws ParseException
```
Parse the variable value to a byte with the help of of the format. The format of the current language setting will be considered.
```
 ParseUtils.parseByte(589, "XDEV");        returns 77
 ParseUtils.parseByte(-3695, "XDEV");      returns -111
 
```
Parameters:

value - the value which will be parsed to byte

pattern - the format with which the value should be parsed

Returns:

the byte parsed from the value, if possible.

Throws:

ParseException - if value could not be parsed to byte

See Also:

parse(Object, String)

parseShort
```
@Deprecated
public static short parseShort(Object value)
                                    throws NumberFormatException
```
Deprecated. use ConversionUtils.toshort(Object)
Parse the variable value to a short.The format of the current language setting will be considered.
Examples
```
 ParseUtils.parseShort(2561);      returns 2561
 ParseUtils.parseShort(-25615);    returns -25615
 
```
Parameters:

value - the value which will be parsed to short

Returns:

the short parsed from the value, if possible.

Throws:

NumberFormatException - if value could not be parsed to short

See Also:

parseShort(Object, String), parseDouble(Object)

parseShort
```
public static short parseShort(Object value,
                               String pattern)
                        throws ParseException
```
Parse the variable value to a short with the help of of the format. The format of the current language setting will be considered.
Examples
```
 ParseUtils.parseShort("0032767", "##0000");            returns 32767
 ParseUtils.parseShort("235.123", "###");                       returns 235
 
```
Parameters:

value - the value which will be parsed to short

pattern - the format with which the value should be parsed

Returns:

the short parsed from the value, if possible.

Throws:

ParseException - if value could not be parsed to short

See Also:

parse(Object, String)

parseInt
```
@Deprecated
public static int parseInt(Object value)
                                throws NumberFormatException
```
Deprecated. use ConversionUtils.toint(Object)
Parse the variable value to an int. The format of the current language setting will be considered.
Examples
```
 ParseUtils.parseInt(56);     returns 56
 ParseUtils.parseInt(-268);   returns -268
 
```
Parameters:

value - the value which will be parsed to int

Returns:

the int parsed from the value, if possible.
Warning: The value has to be between -2.147.483.648 and 2.147.483.647. Beyond that use parseDouble(Object).

Throws:

NumberFormatException - if value could not be parsed to int

See Also:

parseInt(Object, String), parseDouble(Object), parseDouble(Object, String), isInteger(Object), parseLong(Object), parseLong(Object, String)

parseInt
```
public static int parseInt(Object value,
                           String pattern)
                    throws ParseException
```
Parse the variable value to a int with the help of of the format. The format of the current language setting will be considered.
Examples
```
 ParseUtils.parseInt("12.356", "##");           returns 12
 ParseUtils.parseInt("12", "##");                       returns 12
 
```
Parameters:

value - the value which will be parsed to int

pattern - the format with which the value should be parsed

Returns:

the int parsed from the value, if possible.
Warning: The value has to be between -2.147.483.648 and 2.147.483.647. Beyond that use parseDouble(Object, String).

Throws:

ParseException - if value could not be parsed to int

See Also:

parse(Object, String)

parseLong
```
@Deprecated
public static long parseLong(Object value)
                                  throws NumberFormatException
```
Deprecated. use ConversionUtils.tolong(Object)
Parse the variable value to an long. The format of the current language setting will be considered.
Examples
```
 ParseUtils.parseLong(223545854);    returns 223545854
 ParseUtils.parseLong(-545845854);   returns -545845854
 
```
Parameters:

value - the value which will be parsed to long

Returns:

the long parsed from the value, if possible.

Throws:

NumberFormatException - if value could not be parsed to long

See Also:

parseInt(Object), parseDouble(Object), parseDouble(Object), isLong(Object), parseInt(Object, String), parseLong(Object, String), parseDouble(Object, String)

parseLong
```
public static long parseLong(Object value,
                             String pattern)
                      throws ParseException
```
Parse the variable value to a long with the help of of the format. The format of the current language setting will be considered.
Examples
```
 ParseUtils.parseLong("546545,64121.385", ",######");   returns 546545
 ParseUtils.parseLong("546872313", "########");                 returns 546872313
 
```
Parameters:

value - the value which will be parsed to long

pattern - the format with which the value should be parsed

Returns:

the long parsed from the value, if possible.

Throws:

ParseException - if value could not be parsed to long

See Also:

parse(Object, String)

parseFloat
```
@Deprecated
public static float parseFloat(Object value)
                                    throws NumberFormatException
```
Deprecated. use ConversionUtils.tofloat(Object)
Parse the variable value to an float. The format of the current language setting will be considered.
Examples
```
 ParseUtils.parseFloat(545687453);   returns 545687453
 ParseUtils.parseFloat(-564868745);  returns -564868745
 
 
```
Parameters:

value - the value which will be parsed to long

Returns:

the float parsed from the value, if possible.

Throws:

NumberFormatException - if value could not be parsed to float

See Also:

parseInt(Object), parseDouble(Object), parseDouble(Object), parseInt(Object, String), parseLong(Object, String), parseDouble(Object, String)

parseFloat
```
public static float parseFloat(Object value,
                               String pattern)
                        throws ParseException
```
Parse the variable value to a float with the help of of the format. The format of the current language setting will be considered.
Examples
```
 ParseUtils.parseFloat("00003456", "000000");           returns 3456
 ParseUtils.parseFloat("0000014", "000000");            returns 14
 
 
```
Parameters:

value - the value which will be parsed to float

pattern - the format with which the value should be parsed

Returns:

the float parsed from the value, if possible.

Throws:

ParseException - if value could not be parsed to float

See Also:

parse(Object, String)

parseDouble
```
@Deprecated
public static double parseDouble(Object value)
                                      throws NumberFormatException
```
Deprecated. use ConversionUtils.todouble(Object)
Parse the variable value to an double. The format of the current language setting will be considered.
```
 ParseUtils.parseDouble(5.20);    returns 5.20
 ParseUtils.parseDouble(-175.28); returns -175.28
 
```
Parameters:

value - the value which will be parsed to double

Returns:

the double parsed from the value, if possible.

Throws:

NumberFormatException - if value could not be parsed to double

See Also:

parseInt(Object, String), parseDouble(Object), parseDouble(Object, String), isDecimal(Object), parseLong(Object), parseLong(Object, String)

parseDouble
```
public static double parseDouble(Object value,
                                 String pattern)
                          throws ParseException
```
Parse the variable value to a double with the help of of the format. The format of the current language setting will be considered.
Examples
```
 ParseUtils.parseDouble(",35", ".00");       returns 0.35
 ParseUtils.parseDouble("12,340000","#.00"); returns 12.34
 
```
Parameters:

value - the value which will be parsed to double

pattern - the format with which the value should be parsed

Returns:

the double parsed from the value, if possible.

Throws:

ParseException - if value could not be parsed to double

See Also:

parse(Object, String)

parseDoubleAsCurrency

public static double parseDoubleAsCurrency(Object value)

Parse the variable value to an double. Additional characters behind the value will be considered.

Example

 ParseUtils.parseDouble(2587.6998);    returns 2587.6998
 ParseUtils.parseDouble(-5697.6237);   returns -5697.6237

Hint

 Can be used as inverse function to formatAsCurrency(double)

Hint

 If you don't need the extra function to accepted additional characters 
 behind the number you should use parseDouble(Object) instead.
 Because fewer mistakes could be slipped in. 
 And parseDouble(Object) has more performance because fewer cases has to be checked.

Parameters:: value - the value which will be parsed to double
Returns:: the double parsed from the value, if possible.
See Also:: formatAsCurrency(double), parseDoubleAsCurrency(Object, String), parseDouble(Object), parseDouble(Object, String)

parseDoubleAsCurrency
```
public static double parseDoubleAsCurrency(Object value,
                                           String pattern)
                                    throws ParseException
```
Parse the variable value to a double with the help of of the format. The format of the current language setting will be considered. Example
```
 ParseUtils.parseDoubleAsCurrency("12,350000", "#.000000");             returns 12.35
 ParseUtils.parseDoubleAsCurrency("12.345,679", ",###");          returns 12345.679
 
```
Parameters:

value - the value which will be parsed to double

pattern - the format with which the value should be parsed

Returns:

the double parsed from the value, if possible.

Throws:

ParseException - if value could not be parsed to double

See Also:

parse(Object, String), parseDouble(Object, String)

parse
```
public static Number parse(Object value)
                    throws ParseException
```
Parse the variable value to an Number .
Examples
```
 ParseUtils.parse(78);    return 78
 ParseUtils.parse(-256);  return -256
 
```
Parameters:

value - the value which will be parsed to Number

Returns:

the Number parsed from the value, if possible.

Throws:

ParseException - if value could not be parsed to Number

parse

public static Number parse(Object value,
                           String pattern)
                    throws ParseException

Parse the variable value to an Number with the help of of the format. The format of the current language setting will be considered.

Examples
 
 ParseUtils.parse("00000014", "00000000");              returns 14
 ParseUtils.parse("0014000", "0000000");                        returns 14000
 
The following Symbols will be supported:

Symbol
Meaning

0
Represent a digit - is the position empty, will be shown a zero.

#
Represent a digit - is the position empty it stays empty, with that leading zero and unnecessary zeros after the decimal point will be avoided.

.
Decimal separator. Separates external and internal decimal places.

,
Groups the digits (a group is as big as the distance from "," to ".").

;
Delimiter. On the left of it is the pattern for the positive, on the right the format for the negative numbers

-
The standardsymbol for the negativeprefix

%
The number will be multiply with 100 and declared as a percent value

%%
The same as %, only with per mill.

¤ (¤)

National currency sign (&eur; for Germany)

¤¤ (¤¤)
Internationale currency sign (EUR for Germany)

X
All other symbols X can be used as normal.

'
to mask special symbols in prefix or suffix

Format
Intake Number
Result

0000
12
0012

0000
12,5
0012

0000
1234567
1234567

##
12
12

##
12.3456
12

##
123456
123456

.00
12.3456
12,35

.00
.3456
,35

0.00
.789
0,79

#.000000
12.34
12,340000

,###
12345678.901
12.345.679

#.#;(#.#)

12345678.901
12345678,9

#.#;(#.#)
-12345678.901
(12345678,9)

,###.## ¤
12345.6789
12.345,68 i

,#00.00 ¤¤
-12345678.9
-12.345.678,90 EUR

,#00.00 ¤¤
0.1

00,10 EUR

Symbol	Meaning
0	Represent a digit - is the position empty, will be shown a zero.
#	Represent a digit - is the position empty it stays empty, with that leading zero and unnecessary zeros after the decimal point will be avoided.
.	Decimal separator. Separates external and internal decimal places.
,	Groups the digits (a group is as big as the distance from "," to ".").
;	Delimiter. On the left of it is the pattern for the positive, on the right the format for the negative numbers
-	The standardsymbol for the negativeprefix
%	The number will be multiply with 100 and declared as a percent value
%%	The same as %, only with per mill.
¤ (¤)	National currency sign (&eur; for Germany)
¤¤ (¤¤)	Internationale currency sign (EUR for Germany)
X	All other symbols X can be used as normal.
'	to mask special symbols in prefix or suffix

Format	Intake Number	Result
0000	12	0012
0000	12,5	0012
0000	1234567	1234567
##	12	12
##	12.3456	12
##	123456	123456
.00	12.3456	12,35
.00	.3456	,35
0.00	.789	0,79
#.000000	12.34	12,340000
,###	12345678.901	12.345.679
#.#;(#.#)	12345678.901	12345678,9
#.#;(#.#)	-12345678.901	(12345678,9)
,###.## ¤	12345.6789	12.345,68 i
,#00.00 ¤¤	-12345678.9	-12.345.678,90 EUR
,#00.00 ¤¤	0.1	00,10 EUR

Parameters:: value - the value which will be parsed to Number; pattern - the format with which the value should be parsed
Returns:: the Number parsed from the value, if possible.
Throws:: ParseException - if value could not be parsed to Number
See Also:: parse(Object), parseInt(Object), parseInt(Object, String), isDecimal(Object)

parseBoolean

@Deprecated
public static boolean parseBoolean(Object value)

Deprecated. use ConversionUtils.toboolean(Object)

Parse the variable value to boolean .

 Returns true for the following cases:

 Boolean true


 Number != 0


 String "true" (not case sensitive)


 All others cases != null return false

Example

 ParseUtils.parseBoolean(232);      return true
 ParseUtils.parseBoolean(-232);     return true
 ParseUtils.parseBoolean("hello");  return false

Warning: Instead of parseInt(Object) and parseDouble(Object) this methode will never throw a NumberFormatException

Parameters:: value - the value which will be parsed to boolean.
Returns:: true if the value is a boolean, else false
See Also:: isBoolean(Object), parseInt(Object), parseDouble(Object)

parseDate
```
@Deprecated
public static XdevDate parseDate(Object value)
```
Deprecated. use ConversionUtils.toXdevDate(Object)

Ckecks whether Object value is a XdevDate. If yes it returns a XdevDate else null.

Parameters:

value - Object which will be parsed to XdevDate.

Returns:

XdevDate if value is a XdevDate. Else null.

See Also:

parseDate(Object, String), parseUtilDate(Object)

parseDate
```
public static XdevDate parseDate(Object value,
                                 String pattern)
```
Ckecks whether Object value is a XdevDate. If yes it returns a XdevDate else null.
Examples
```
 ParseUtils.parseDate("10.01.2010", "dd.MM.yyyy");  returns 10.01.2010
 
```
Hint
```
        For valid patterns see SimpleDateFormat
 
```
Parameters:

value - Object which will be parsed to XdevDate.

pattern - the format with which the value should be parsed.

Returns:

XdevDate if value is a XdevDate. Else null.

See Also:

parseDate(Object), parseUtilDate(Object)

parseUtilDate
```
@Deprecated
public static Date parseUtilDate(Object value)
```
Deprecated. use ConversionUtils.toDate(Object)

Ckecks whether Object value is a Date. If yes it returns a Date else null.

Parameters:

value - Object which will be parsed to Date.

Returns:

XdevDate if value is a Date. Else null.

See Also:

parseDate(Object, String), parseDate(Object)

parseList
```
@Deprecated
public static XdevList parseList(Object value)
```
Deprecated. use ConversionUtils.toXdevList(Object)

Ckecks whether Object value is a XdevList. If yes it returns a XdevList else null.

Parameters:

value - Object which will be parsed to XdevList.

Returns:

XdevDate if value is a XdevList. Else null.

parseHashtable
```
@Deprecated
public static XdevHashtable parseHashtable(Object value)
```
Deprecated. use ConversionUtils.toXdevHashtable(Object)

Ckecks whether Object value is a XdevHashtable. If yes it returns a XdevHashtable else null.

Parameters:

value - Object which will be parsed to XdevHashtable.

Returns:

XdevHashtable if value is a XdevHashtable. Else null.

parseFile
```
@Deprecated
public static XdevFile parseFile(Object value)
```
Deprecated. use ConversionUtils.toXdevFile(Object)

Ckecks whether Object value is a XdevFile. If yes it returns a XdevFile else null.

Parameters:

value - Object which will be parsed to XdevFile.

Returns:

XdevFile if value is a XdevFile. Else null.

parseImage
```
@Deprecated
public static XdevImage parseImage(Object value)
```
Deprecated. use ConversionUtils.toXdevImage(Object)

Ckecks whether Object value is a XdevImage. If yes it returns a XdevImage else null.

Parameters:

value - Object which will be parsed to XdevImage.

Returns:

XdevImage if value is a XdevImage. Else null.

toHexString
```
public static String toHexString(int i)
```
Parse the variable i to HexString.
Examples
```
 ParseUtils.toHexString(25);     returns 19
 ParseUtils.toHexString(-62);    returns ffffffc2
 
```
Parameters:

i - int which will be parsed to HexString

Returns:

String HexSring parsed from i

See Also:

Integer.toHexString(int)

toHexString
```
public static String toHexString(long l)
```
Parse the variable l to HexString.
Examples
```
 ParseUtils.toHexString(-25897);      returns ffff9ad7
 ParseUtils.toHexString(2589);        returns a1d
 
 
```
Parameters:

l - long which will be parsed to HexString

Returns:

String HexSring parsed from l

See Also:

Long.toHexString(long)

toOctalString
```
public static String toOctalString(int i)
```
Parse the variable i to OctalString.
Examples
```
 ParseUtils.toOctalString(597632);       returns 2217200
 ParseUtils.toOctalString(-1025897);     returns 37774054227
 
 
```
Parameters:

i - int which will be parsed to OctalString

Returns:

String OctalString parsed from i

See Also:

Integer.toOctalString(int)

toOctalString

public static String toOctalString(long l)

Parse the variable l to OctalString.

Examples

 ParseUtils.toOctalString(1025856889);       returns 7511252571
 ParseUtils.toOctalString(-589789567);       returns 33466103201

Parameters:: l - long which will be parsed to OctalString
Returns:: String OctalString parsed from l
See Also:: Long.toOctalString(long)

toBinaryString

public static String toBinaryString(int i)

Parse the variable i to BinaryString.

Examples

 ParseUtils.toBinaryString(-589789567);      returns 11011100110110001000011010000001
 ParseUtils.toBinaryString(897898967);       returns 110101100001001101100111010111

Parameters:: i - int which will be parsed to BinaryString
Returns:: String BinaryString parsed from i
See Also:: Integer.toBinaryString(int)

toBinaryString

public static String toBinaryString(long l)

Parse the variable l to BinaryString.

Examples

 ParseUtils.toBinaryString(897295967);       returns 110101011110111010011001011111
 ParseUtils.toBinaryString(-831878067);      returns 11001110011010101000110001001101

Parameters:: l - long which will be parsed to BinaryString
Returns:: String BinaryString parsed from l
See Also:: Long.toBinaryString(long)

isNumeric
```
public static boolean isNumeric(Object value,
                                long min,
                                long max)
```
Checks if the variable value is a value between min and max. With the condition: min <= value <= max.
Examples
```
 ParseUtils.isNumeric(489999995, 12000, 698777);     returns false
 ParseUtils.isNumeric(5000, 5000, 5000);             returns true
 
 
```
Parameters:

value - the value which will be checked

min - the(inclusive)lower border for value

max - the(inclusive)upper border for value

Returns:

true if min <= value <= max

See Also:

isAlphaNumeric(String, int, int), isNumeric(Object, double, double)

isNumeric

public static boolean isNumeric(Object value,
                                double min,
                                double max)

* Checks if the variable value is a value between min and max. With the condition: min <= value <= max.

Examples

 ParseUtils.isNumeric(5600.80, 500.20, 4000.90);     returns false
 ParseUtils.isNumeric(-5000.90, -489.25, -800.65);   returns false
 ParseUtils.isNumeric(-5000.90, -5000.90, -5000.90); returns true

Parameters:: value - the value which will be checked; min - the(inclusive)lower border for value; max - the(inclusive)upper border for value
Returns:: true if min <= value <= max
See Also:: isAlphaNumeric(String, int, int), isNumeric(Object, long, long)

isAlphaNumeric
```
public static boolean isAlphaNumeric(String value,
                                     int min,
                                     int max)
```
Checks if the variable String is not a number and is it has a length between minLen and maxLen. If this applies it returns true, else false.
Example
```
 ParseUtils.isAlphaNumeric("Hello10", 2, 30);         returns true
 ParseUtils.isAlphaNumeric("Hello-15", -40, 30);      returns true
 ParseUtils.isAlphaNumeric("Hello XDEV3", -40, -15);  returns false
 
```
Parameters:

value - the String which length will be checked

min - the(inclusive)minimum length for value

max - the(inclusive)maximum length for value

Returns:

true if minLen <= value.length <= maxLen

See Also:

isNumeric(Object, double, double), isNumeric(Object, long, long)

isEmail

public static boolean isEmail(String value)

Checks if the variable String is a valid Email address.

Example

 ParseUtils.isEmail("[email protected]"); returns true
 ParseUtils.isEmail(" ");                              returns false

Hint

 It can only be checked whether the String has the right format for an email address, not whether this email address truely exists.

Parameters:: value - the String which format will be checked
Returns:: true if the String has a valid email address format.
See Also:: isNumeric(Object, double, double), isNumeric(Object, long, long)

format

public static String format(long l)

Formats the long l with the actual language setting and returns it as String.

Example

 ParseUtils.format(894302256);   returns 894.302.256
 ParseUtils.format(-789602314);  returns -789.602.314

 The german standard setting for decimals is:

 Thousand delimiter "."


 decimal point ","


 round to 3 decimal places

Parameters:: l - the long which will be formated.
Returns:: long in format of the actual language setting.
See Also:: format(double), format(long, String)

format

public static String format(long l,
                            String pattern)

Formates the number l to a String with the help of the format.

Example

 ParseUtils.format(789302125, "Lange Zahl ");     returns Lange Zahl 789302125
 ParseUtils.format(-569780212, "Negative Zahl "); returns -Negative Zahl 569780212

Hint

 for valid patterns see parse(Object, String)

Parameters:: l - the long which will be formated.; pattern - the String with which l will be formated.
Returns:: l formated with pattern pattern.
See Also:: format(long), format(double, String)

format

public static String format(double d)

Formats the double d with the actual language setting and returns it as String.

Example

 
 ParseUtils.format(2000.3505);       returns 2.000,35
 ParseUtils.format(-23205.3589705);  returns -23.205,359

 The german standard setting for decimals is:

 Thousand delimiter "."


 decimal point ","


 round to 3 decimal places

Parameters:: d - the double which will be formated.
Returns:: double in format of the actual language setting.
See Also:: format(long), format(double, String)

format

public static String format(double d,
                            String pattern)

Formates the number l to a String with the help of the format. Example

 ParseUtils.format(-7892.0365478, "Euro");    returns -Euro7892
 ParseUtils.format(25897.6321, "hello");      returns hello25898

Parameters:: d - the long which will be formated.; pattern - the String with which l will be formated.
Returns:: l formated with pattern pattern.
See Also:: format(long, String), format(double)

formatAsCurrency

public static String formatAsCurrency(long l)

Formates the long l as currency with the actual language setting and returns it as String.

Example

 
 ParseUtils.formatAsCurrency(897565258);     returns 897.565.258,00 €
 ParseUtils.formatAsCurrency(-45752378);     returns -45.752.378,00 €

Hint

 The german default setting for currency is:

 Thousand delimiter "."


 decimal point ","


 round to 2 decimal places 


 closing "€"-sign with preceding space

Parameters:: l - the long which will be formated as currency
Returns:: the long formated as currency with the actual language setting.
See Also:: format(double), format(long, String), parseDouble(Object), parseDouble(Object, String)

formatAsCurrency

public static String formatAsCurrency(double d)

Formates the double d as currency with the actual language setting and returns it as String.

Example

 ParseUtils.formatAsCurrency(78963.256);     returns 78.963,26 €
 ParseUtils.formatAsCurrency(-458.256);      returns -458,26 €

Hint

 The german default setting for currency is:

 Thousand delimiter "."


 decimal point ","


 round to 2 decimal places 


 closing "€"-sign with preceding space

Parameters:: d - the double which will be formated as currency
Returns:: the double formated as currency with the actual language setting.
See Also:: format(double), format(long, String), parseDouble(Object), parseDouble(Object, String)

castTo
```
public static Object castTo(Object value,
                            Class type)
```
Checks whether Object value is a type of Class type. If yes it returns value else ClassCastException.

Parameters:

value - Object which type will be checked

type - Class of which Object will be checked.

Returns:

value if value is type of type. Else ClassCastException.

See Also:

isType(Object, String), isType(Object, Class)

isType
```
public static boolean isType(Object value,
                             Class type)
```
Checks whether Object value is a type of Class type. If yes it returns true else false.

Parameters:

value - Object which type will be checked

type - Class of which Object will be checked.

Returns:

true if Object is type of type. Else false.

See Also:

isType(Object, String)

isType
```
public static boolean isType(Object value,
                             String className)
```
Checks whether Object value is a type of Class className. If yes it returns true else false.
Example
```
 ParseUtils.isType(65, "double");               returns false
 
 
```
Parameters:

value - Object which type will be checked

className - className of which Object will be checked.

Returns:

true if Object is type of className. Else false.

See Also:

isType(Object, Class)

isInteger
```
public static boolean isInteger(Object value)
```
Checks if the Object value is an integer. That means whether value can be parsed to an integer without losing information.
Example
```
 
 ParseUtils.isInteger(20);     returns true
 ParseUtils.isInteger(null);   returns false
 
 
```
```
 The number range of Integer is between -2.147.483.648 and 2.147.483.647 .
 
```
Parameters:

value - the Object value which will be checked

Returns:

true if value is an integer or can be parsed to without losing information

See Also:

isInteger(Object), isDecimal(Object), isBoolean(Object), parseLong(Object), parseLong(Object, String)

isLong
```
public static boolean isLong(Object value)
```
Checks if the Object value is an integer. That means whether value can be parsed to an integer without losing information.
Example ParseUtils.isLong(20875884855699l); returns true ParseUtils.isLong(null); returns false
```
 The number range of long is between -9.223.372.036.854.775.808 and 9.223.372.036.854.775.807 .
 
```
Parameters:

value - the Object value which will be checked

Returns:

true if value is an integer or can be parsed to without losing information

See Also:

isLong(Object), isDecimal(Object), isBoolean(Object), parseLong(Object), parseLong(Object, String)

isDecimal

public static boolean isDecimal(Object value)

Checks if the Object value is a decimal or can parsed to.

1. General

 isDecimal("3.14")
 
 returns true

2. Integer

 isDecimal("5")
 
 returns true.

3. Zero

 isDecimal("0")
 
 returns true.

4. Exponent spelling 1

 isDecimal("1E3")
 
 
 returns true.
 (1E3 = 1 * 10³ = 1000)

5. Exponent spelling 2

 isDecimal(1E-3)
 
 returns true.
 (1E3 = 1 * 10^-3 = 0,001)

6. Not a number

 isDecimal("NaN")
 
 returns true.

7. Minus infinity

 isDecimal("Infinity") 
 
 returns true.

8. Minus infinity

 isDecimal("-Infinity")
 
 returns true.

Hint

 The check wil be made with the regular expression:
 ^[a-zA-Z0-9._%-]+@[a-zA-ZÄÖÜäöü0-9._%-]+\\.[a-zA-Z]{2,4}$

Hint

 "NaN", "Infinity" and "-Infinity" are case sensitive.
 That means "NAN", "nan", "infinity", "INFINITY", etc can't be recognized.
 Also "Negative Infinity" or something like that can't be recognized.
 
 For the exponent notation can instead of "E" also "e" be used. 
 Likewise, "5E09", "0E4" or "6.5E12" can be used too. Is not possible to use  e.g. "E3" or "5E9.1"

Hint

 This methode has approximately the same performance as parseDouble(Object).
 That means if Object value will be used as decimal, after this methode, it is convenient 
 to write:
 

   

 

 ParseUtils.isDecimal(200.05); returns true
 ParseUtils.isDecimal(null);   returns false
 

 

  
 With this the check will be made only once.

Parameters:: value - the Object value which will be checked
Returns:: true if value is a decimal or can be parsed to.
See Also:: isInteger(Object), isNumeric(Object, double, double), parseDouble(Object)

isBoolean
```
public static boolean isBoolean(Object value)
```
Checks if the variable value is type of boolean .
```
 simple
 ParseUtils.isBoolean(true) 
 ParseUtils.isBoolean(false) 
 
 Returns true.
 
 other Value
 isBoolean("true") 
 isBoolean(5) 
 isBoolean("alles andere")
 
 Returns false. 
 (also "true" isnt a Boolean, because the type is a String)
 
```
*
Warning: While parseBoolean(Object) trys to parse a given value to boolean, checks this methode not if a given value can be parsed to boolean, but if a given value is type of boolean. To check if a value (like the String "true") can be interprete as boolean can be used the following Code: ParseUtils.isBoolean(null); returns false ParseUtils.isBoolean(150); returns false
Parameters:

value - the value which will be checked if its is a boolean.

Returns:

true if the value is a boolean, else false

See Also:

parseBoolean(Object), isInteger(Object), isDecimal(Object), isLong(Object)

Class ParseUtils

Method Summary

Methods inherited from class java.lang.Object

Method Detail

parseByte

parseByte

parseShort

parseShort

parseInt

parseInt

parseLong

parseLong

parseFloat

parseFloat

parseDouble

parseDouble

parseDoubleAsCurrency

parseDoubleAsCurrency

parse

parse

parseBoolean

parseDate

parseDate

parseUtilDate

parseList

parseHashtable

parseFile

parseImage

toHexString

toHexString

toOctalString

toOctalString

toBinaryString

toBinaryString

isNumeric

isNumeric

isAlphaNumeric

isEmail

format

format

format

format

formatAsCurrency

formatAsCurrency

castTo

isType

isType

isInteger

isLong

isDecimal

isBoolean