de.lmu.ifi.dbs.elki.utilities.optionhandling.parameters

Class Flag

java.lang.Object

de.lmu.ifi.dbs.elki.utilities.optionhandling.parameters.AbstractParameter<Flag,java.lang.Boolean>

de.lmu.ifi.dbs.elki.utilities.optionhandling.parameters.Flag

All Implemented Interfaces:

Parameter<java.lang.Boolean>

public class Flag
extends AbstractParameter<Flag,java.lang.Boolean>

Option class specifying a flag object.

A flag object is optional parameter which can be set (value "true") or not (value "false").

Since:

0.3

Author:

Steffi Wanka, Erich Schubert

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	NOT_SET Constant indicating that the flag is not set.
static java.lang.String	SET Constant indicating that the flag is set.

Fields inherited from class de.lmu.ifi.dbs.elki.utilities.optionhandling.parameters.AbstractParameter

constraints, defaultValue, givenValue, optionalParameter, optionid, shortDescription

Constructor Summary

Constructors

Constructor and Description
Flag(OptionID optionID) Constructs a flag object with the given optionID.

Method Summary

Modifier and Type	Method and Description
java.lang.String	getSyntax() A flag has no syntax, since it doesn't take extra options
java.lang.String	getValueAsString() Get the value as string.
boolean	isFalse() Shorthand for isDefined() && getValue() == false
boolean	isTrue() Shorthand for isDefined() && getValue() == true
protected java.lang.Boolean	parseValue(java.lang.Object obj) Parse a given value into the destination type.
void	setValue(boolean val) Convenience function using a native boolean, that doesn't require error handling.
protected boolean	validate(java.lang.Boolean obj) Validate a value after parsing (e.g. do constraint checks!)

Methods inherited from class de.lmu.ifi.dbs.elki.utilities.optionhandling.parameters.AbstractParameter

addConstraint, describeValues, getConstraints, getDefaultValue, getDefaultValueAsString, getOptionID, getShortDescription, getValue, hasDefaultValue, isDefined, isOptional, isValid, setDefaultValue, setOptional, setShortDescription, setValue, setValueInternal, tookDefaultValue, tryDefaultValue

Methods inherited from class java.lang.Object

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

Field Detail

SET

public static final java.lang.String SET

Constant indicating that the flag is set.

See Also:

Constant Field Values

NOT_SET

public static final java.lang.String NOT_SET

Constant indicating that the flag is not set.

See Also:

Constant Field Values

Constructor Detail

Flag

public Flag(OptionID optionID)

Constructs a flag object with the given optionID.

If the flag is not set its value is "false".

Parameters:

optionID - the unique id of the option

Method Detail

parseValue

protected java.lang.Boolean parseValue(java.lang.Object obj)
                                throws ParameterException

Description copied from class: AbstractParameter

Parse a given value into the destination type.

Specified by:

parseValue in class AbstractParameter<Flag,java.lang.Boolean>

Parameters:

obj - Object to parse (may be a string representation!)

Returns:

Parsed object

Throws:

ParameterException - when the object cannot be parsed.

getSyntax

public java.lang.String getSyntax()

A flag has no syntax, since it doesn't take extra options

Specified by:

getSyntax in interface Parameter<java.lang.Boolean>

Specified by:

getSyntax in class AbstractParameter<Flag,java.lang.Boolean>

Returns:

a string representation of the parameter's type

getValueAsString

public java.lang.String getValueAsString()

Description copied from interface: Parameter

Get the value as string. May return null

Specified by:

getValueAsString in interface Parameter<java.lang.Boolean>

Specified by:

getValueAsString in class AbstractParameter<Flag,java.lang.Boolean>

Returns:

Value as string

validate

protected boolean validate(java.lang.Boolean obj)
                    throws ParameterException

Description copied from class: AbstractParameter

Validate a value after parsing (e.g. do constraint checks!)

Overrides:

validate in class AbstractParameter<Flag,java.lang.Boolean>

Parameters:

obj - Object to validate

Returns:

true iff the object is valid for this parameter.

Throws:

ParameterException - when the object is not valid.

setValue

public void setValue(boolean val)

Convenience function using a native boolean, that doesn't require error handling.

Parameters:

val - boolean value

isTrue

public boolean isTrue()

Shorthand for isDefined() && getValue() == true

Returns:

true when defined and true.

isFalse

public boolean isFalse()

Shorthand for isDefined() && getValue() == false

Returns:

true when defined and true.