com.pervasive.datarush.encoding.text

Class ISOTimeOfDayParser

java.lang.Object

com.pervasive.datarush.encoding.text.ISOTimeOfDayParser

All Implemented Interfaces:

TokenParser

public class ISOTimeOfDayParser
extends Object

A parser producing time token values from time-of-day expressed in ISO 8601 format. The date portion will default to the current date. If no timezone is associated with the time, it will be assumed to be the in the local timezone.

Constructor Summary

Constructors

Constructor and Description
ISOTimeOfDayParser() Creates a new parser.
ISOTimeOfDayParser(String nullIndicator) Creates a parser using the specified format.

Method Summary

Modifier and Type	Method and Description
String	getParseError() When parse method returns false this method can be used to retrieve the specific error message detailing why the parsing failed.
boolean	parse(String text) Parses the given text string into a token value.
protected void	setParseError(String msg)
void	setTarget(ScalarSettable output) Sets the buffer for holding parsed values.

Methods inherited from class java.lang.Object

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

Constructor Detail

ISOTimeOfDayParser

public ISOTimeOfDayParser()

Creates a new parser. Only empty strings are treated as null.

ISOTimeOfDayParser

public ISOTimeOfDayParser(String nullIndicator)

Creates a parser using the specified format. Empty strings and the specified text value are treated as null.

Parameters:

nullIndicator - the text value representing null

Method Detail

setTarget

public final void setTarget(ScalarSettable output)

Description copied from interface: TokenParser

Sets the buffer for holding parsed values. A reference to this container is held and accessed only when an formatting is requested.

Specified by:

setTarget in interface TokenParser

Parameters:

output - the value buffer in which to store parsed values

parse

public final boolean parse(String text)

Description copied from interface: TokenParser

Parses the given text string into a token value. If the parse succeeds, the result is stored in the target buffer. If it fails, the contents of the target buffer are unchanged and information regarding failure will be saved that is accessible by calling the getParseError method.

Specified by:

parse in interface TokenParser

Parameters:

text - text string to convert. Callers should not assume it is safe to pass null.

Returns:

true if the parsing succeeded, false otherwise.

setParseError

protected final void setParseError(String msg)

getParseError

public final String getParseError()

Description copied from interface: TokenParser

When parse method returns false this method can be used to retrieve the specific error message detailing why the parsing failed. If the last parse was successful an empty string will be returned

Specified by:

getParseError in interface TokenParser

Returns:

a message detailing any parse errors that occurred during the last call to parse.