com.martiansoftware.jsap.stringparsers.BigDecimalStringParser Maven / Gradle / Ivy
Show all versions of jsap Show documentation
/*
* Copyright (c) 2002-2004, Martian Software, Inc.
* This file is made available under the LGPL as described in the accompanying
* LICENSE.TXT file.
*/
package com.martiansoftware.jsap.stringparsers;
import com.martiansoftware.jsap.StringParser;
import com.martiansoftware.jsap.ParseException;
import java.math.BigDecimal;
/**
* A {@link com.martiansoftware.jsap.StringParser} for parsing BigDecimals. The parse() method delegates the
* actual
* parsing to BigDecimal's constructor.
* @author Marty Lamb
* @see com.martiansoftware.jsap.StringParser
* @see java.math.BigDecimal
*/
public class BigDecimalStringParser extends StringParser {
private static final BigDecimalStringParser INSTANCE = new BigDecimalStringParser();
/** Returns a {@link BigDecimalStringParser}.
*
* Convenient access to the only instance returned by
* this method is available through
* {@link com.martiansoftware.jsap.JSAP#BIGDECIMAL_PARSER}.
*
* @return a {@link BigDecimalStringParser}.
*/
public static BigDecimalStringParser getParser() {
return INSTANCE;
}
/**
* Creates a new BigDecimalStringParser.
* @deprecated Use {@link #getParser()} or, even better, {@link com.martiansoftware.jsap.JSAP#BIGDECIMAL_PARSER}.
*/
public BigDecimalStringParser() {
super();
}
/**
* Parses the specified argument into a BigDecimal. This method simply
* delegates
* the parsing to new BigDecimal(String). If BigDecimal
* throws a
* NumberFormatException, it is encapsulated into a ParseException and
* re-thrown.
*
* @param arg the argument to parse
* @return a BigDecimal object with the value contained in the specified
* argument.
* @throws ParseException if new BigDecimal(arg) throws a
* NumberFormatException.
* @see BigDecimal
* @see com.martiansoftware.jsap.StringParser#parse(String)
*/
public Object parse(String arg) throws ParseException {
BigDecimal result = null;
try {
result = new BigDecimal(arg);
} catch (NumberFormatException e) {
throw (
new ParseException(
"Unable to convert '" + arg + "' to a BigDecimal.",
e));
}
return (result);
}
}