com.martiansoftware.jsap.stringparsers

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 and Description
CharacterStringParser() Deprecated. Use getParser() or, even better, JSAP.CHARACTER_PARSER.

Method Summary

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

Methods inherited from class com.martiansoftware.jsap.StringParser

setUp, tearDown

Methods inherited from class java.lang.Object

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

Constructor Detail

CharacterStringParser

public CharacterStringParser()

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

Creates a new CharacterStringParser.

Method Detail

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)