Class CharacterStringParser

java.lang.Object

com.martiansoftware.jsap.StringParser

com.martiansoftware.jsap.stringparsers.CharacterStringParser

public class CharacterStringParser
extends StringParser

A StringParser for parsing Characters. The parse() method requires an argument of length exactly equal to 1 in order to perform the conversion; otherwise, a ParseException is thrown.

Author:

Marty Lamb

See Also:

• StringParser
• Character

Constructor Summary

Constructors

Constructor	Description
CharacterStringParser()	Deprecated. Use getParser() or, even better, JSAP.CHARACTER_PARSER.

Method Summary

Modifier and Type	Method	Description
static CharacterStringParser	getParser()	Returns a CharacterStringParser.
Object	parse(String arg)	Parses the specified argument into a Character.

Methods inherited from class StringParser

setUp, tearDown

Methods inherited from class Object

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

Constructor Details

CharacterStringParser

public CharacterStringParser()

Deprecated.

Use getParser() or, even better, JSAP.CHARACTER_PARSER.

Creates a new CharacterStringParser.

Method Details

getParser

public static CharacterStringParser getParser()

Returns a CharacterStringParser.

Convenient access to the only instance returned by this method is available through JSAP.CHARACTER_PARSER.

Returns:

a CharacterStringParser.

parse

public Object parse(String arg)
             throws ParseException

Parses the specified argument into a Character. The conversion is performed by checking that the specified argument is exactly 1 character long, then encapsulating that char in a Character object. If the specified argument is not exactly 1 character long, a ParseException is thrown.

Specified by:

parse in class StringParser

Parameters:

arg - the argument to parse

Returns:

a Character object with the value contained in the specified argument.

Throws:

ParseException - if ( (arg==null) || (arg.length()!=1) )

See Also:

• Character
• StringParser.parse(String)