com.bergerkiller.bukkit.common.utils

Class ParseUtil

java.lang.Object

com.bergerkiller.bukkit.common.utils.ParseUtil

public class ParseUtil
extends Object

Constructor Summary

Constructors

Constructor and Description
ParseUtil()

Method Summary

Modifier and Type	Method and Description
static <T> T	convert(Object object, Class<T> type) Tries to convert a given Object to the type specified
static <T> T	convert(Object object, Class<T> type, T def) Tries to convert a given Object to the type specified
static <T> T	convert(Object object, T def) Tries to convert a given Object to the type specified The default value can not be null!
static String	filterNumeric(String text) Attempts to filter all non-numeric values from the text specified - Commas are changed to dots - Text after a space is excluded - Non-digit information is erased - Prefixed text is ignored - A single dot maximum is enforced - Null input returns an empty String instead
static boolean	isBool(String text) Checks if a given value is a full valid boolean
static boolean	isNumeric(String text) Checks if the given value is a full valid number
static <T> T	parseArray(T[] values, String text, T def) Tries to parse the text to one of the values in the array specified
static boolean	parseBool(String text) Parses the text specified to a boolean
static Boolean	parseBool(String text, Boolean def) Parses the text specified to a boolean
static float	parseByte(String text, byte def) Tries to parse the text specified to a byte
static Byte	parseByte(String text, Byte def) Tries to parse the text specified to a byte
static double	parseDouble(String text, double def) Tries to parse the text specified to a double
static Double	parseDouble(String text, Double def) Tries to parse the text specified to a double
static <T> T	parseEnum(Class<T> enumClass, String text, T def) Tries to parse the text to one of the values in the Enum specified
static <T> T	parseEnum(String text, T def) Tries to parse the text to one of the values in the Enum specified The default value is used to obtain the class to look in, it can not be null!
static float	parseFloat(String text, float def) Tries to parse the text specified to a float
static Float	parseFloat(String text, Float def) Tries to parse the text specified to a float
static int	parseInt(String text, int def) Tries to parse the text specified to an int
static Integer	parseInt(String text, Integer def) Tries to parse the text specified to an int
static long	parseLong(String text, long def) Tries to parse the text specified to a long
static Long	parseLong(String text, Long def) Tries to parse the text specified to a long
static org.bukkit.Material	parseMaterial(String text, org.bukkit.Material def) Tries to parse the text to one of the values in the Material class
static org.bukkit.Material	parseMaterial(String text, org.bukkit.Material def, boolean legacy) Deprecated.
static Byte	parseMaterialData(String text, org.bukkit.Material material, Byte def) Deprecated.
static int	parseMaterialData(String text, org.bukkit.Material material, int def) Deprecated.
static float	parseShort(String text, short def) Tries to parse the text specified to a short
static Short	parseShort(String text, Short def) Tries to parse the text specified to a short
static long	parseTime(String timestring) Parses a time value from a String.
static org.bukkit.TreeSpecies	parseTreeSpecies(String text, org.bukkit.TreeSpecies def) Tries to parse the text to one of the values in the TreeSpecies class

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ParseUtil

public ParseUtil()

Method Detail

filterNumeric

public static String filterNumeric(String text)

Attempts to filter all non-numeric values from the text specified

- Commas are changed to dots
- Text after a space is excluded
- Non-digit information is erased
- Prefixed text is ignored
- A single dot maximum is enforced
- Null input returns an empty String instead

Parameters:

text - to filter

Returns:

filtered text

isNumeric

public static boolean isNumeric(String text)

Checks if the given value is a full valid number

Parameters:

text - to check

Returns:

True if it is a number, False if it isn't

isBool

public static boolean isBool(String text)

Checks if a given value is a full valid boolean

Parameters:

text - to check

Returns:

True if it is a boolean, False if it isn't

parseBool

public static boolean parseBool(String text)

Parses the text specified to a boolean

Parameters:

text - to parse

Returns:

Parsed value, false when not a known yes value

parseBool

public static Boolean parseBool(String text,
                                Boolean def)

Parses the text specified to a boolean

Parameters:

text - to parse

def - value to return if the text is not a boolean expression

Returns:

Parsed value, or the default

parseFloat

public static float parseFloat(String text,
                               float def)

Tries to parse the text specified to a float

Parameters:

text - to parse

def - to return on failure

Returns:

Parsed or default value

parseFloat

public static Float parseFloat(String text,
                               Float def)

Tries to parse the text specified to a float

Parameters:

text - to parse

def - to return on failure

Returns:

Parsed or default value

parseDouble

public static double parseDouble(String text,
                                 double def)

Tries to parse the text specified to a double

Parameters:

text - to parse

def - to return on failure

Returns:

Parsed or default value

parseDouble

public static Double parseDouble(String text,
                                 Double def)

Tries to parse the text specified to a double

Parameters:

text - to parse

def - to return on failure

Returns:

Parsed or default value

parseLong

public static long parseLong(String text,
                             long def)

Tries to parse the text specified to a long

Parameters:

text - to parse

def - to return on failure

Returns:

Parsed or default value

parseLong

public static Long parseLong(String text,
                             Long def)

Tries to parse the text specified to a long

Parameters:

text - to parse

def - to return on failure

Returns:

Parsed or default value

parseInt

public static int parseInt(String text,
                           int def)

Tries to parse the text specified to an int

Parameters:

text - to parse

def - to return on failure

Returns:

Parsed or default value

parseInt

public static Integer parseInt(String text,
                               Integer def)

Tries to parse the text specified to an int

Parameters:

text - to parse

def - to return on failure

Returns:

Parsed or default value

parseShort

public static float parseShort(String text,
                               short def)

Tries to parse the text specified to a short

Parameters:

text - to parse

def - to return on failure

Returns:

Parsed or default value

parseShort

public static Short parseShort(String text,
                               Short def)

Tries to parse the text specified to a short

Parameters:

text - to parse

def - to return on failure

Returns:

Parsed or default value

parseByte

public static float parseByte(String text,
                              byte def)

Tries to parse the text specified to a byte

Parameters:

text - to parse

def - to return on failure

Returns:

Parsed or default value

parseByte

public static Byte parseByte(String text,
                             Byte def)

Tries to parse the text specified to a byte

Parameters:

text - to parse

def - to return on failure

Returns:

Parsed or default value

parseTime

public static long parseTime(String timestring)

Parses a time value from a String. Supported formats:
- Seconds only (can be a double value)
- Minutes:Seconds (int values)
- Hours:Minutes:Seconds (int values)

Parameters:

timestring - to parse

Returns:

time in milliseconds

parseArray

public static <T> T parseArray(T[] values,
                               String text,
                               T def)

Tries to parse the text to one of the values in the array specified

Parameters:

values - array to look for a value

text - to parse

def - to return on failure

Returns:

Parsed or default value

parseEnum

public static <T> T parseEnum(String text,
                              T def)

Tries to parse the text to one of the values in the Enum specified
The default value is used to obtain the class to look in, it can not be null!

Parameters:

text - to parse

def - to return on failure

Returns:

Parsed or default value

parseEnum

public static <T> T parseEnum(Class<T> enumClass,
                              String text,
                              T def)

Tries to parse the text to one of the values in the Enum specified

Parameters:

enumClass - to look for a value

text - to parse

def - to return on failure

Returns:

Parsed or default value

parseTreeSpecies

public static org.bukkit.TreeSpecies parseTreeSpecies(String text,
                                                      org.bukkit.TreeSpecies def)

Tries to parse the text to one of the values in the TreeSpecies class

Parameters:

text - to parse

def - to return on failure

Returns:

Parsed or default value

parseMaterial

public static org.bukkit.Material parseMaterial(String text,
                                                org.bukkit.Material def)

Tries to parse the text to one of the values in the Material class

Parameters:

text - to parse

def - to return on failure

Returns:

Parsed or default value

parseMaterial

@Deprecated
public static org.bukkit.Material parseMaterial(String text,
                                                            org.bukkit.Material def,
                                                            boolean legacy)

Deprecated.

Tries to parse the text to one of the values in the Material class. When legacy is specified and set to True, only legacy material types will be parsed from name.
Deprecated: legacy Material API is deprecated will be removed

Parameters:

text -

def -

legacy -

Returns:

Parsed or default value

parseMaterialData

@Deprecated
public static Byte parseMaterialData(String text,
                                                 org.bukkit.Material material,
                                                 Byte def)

Deprecated.

Old version of parseMaterialData - please use the int version, as data is more than a byte
Deprecated: data values are part of legacy Material API and will be removed

parseMaterialData

@Deprecated
public static int parseMaterialData(String text,
                                                org.bukkit.Material material,
                                                int def)

Deprecated.

Tries to parse the text to a data value for a Material.
Deprecated: data values are part of legacy Material API and will be removed

Parameters:

text - to parse

material - to parse the text against

def - to return on failure (hint: use -1)

Returns:

Parsed or default value

convert

public static <T> T convert(Object object,
                            Class<T> type)

Tries to convert a given Object to the type specified

Parameters:

object - to convert

type - to convert to

Returns:

The convered object, or null if not possible

convert

public static <T> T convert(Object object,
                            T def)

Tries to convert a given Object to the type specified
The default value can not be null!

Parameters:

object - to convert

def - to return on failure

Returns:

The convered object, or the default if not possible

convert

public static <T> T convert(Object object,
                            Class<T> type,
                            T def)

Tries to convert a given Object to the type specified

Parameters:

object - to convert

type - to convert to

def - to return on failure

Returns:

The convered object, or the default if not possible