Package org.incendo.cloud.parser.standard

Class DoubleParser<C>

java.lang.Object

org.incendo.cloud.parser.standard.NumberParser<C,Double,DoubleRange>

org.incendo.cloud.parser.standard.DoubleParser<C>

All Implemented Interfaces:

ArgumentParser<C,Double>, SuggestionProviderHolder<C>

@API(status=STABLE)
public final class DoubleParser<C>
extends NumberParser<C,Double,DoubleRange>

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	DoubleParser.DoubleParseException

Nested classes/interfaces inherited from interface org.incendo.cloud.parser.ArgumentParser

ArgumentParser.FutureArgumentParser<C,T>

Field Summary

Fields

Modifier and Type	Field	Description
static final double	DEFAULT_MAXIMUM	Constant for the default/unset maximum value.
static final double	DEFAULT_MINIMUM	Constant for the default/unset minimum value.

Constructor Summary

Constructors

Constructor	Description
DoubleParser(double min, double max)	Construct a new double parser

Method Summary

Modifier and Type	Method	Description
static <C> @NonNull CommandComponent.Builder<C,Double>	doubleComponent()	Returns a CommandComponent.Builder using doubleParser() as the parser.
static <C> @NonNull ParserDescriptor<C,Double>	doubleParser()	Creates a new double parser using DEFAULT_MINIMUM and DEFAULT_MAXIMUM as the limits.
static <C> @NonNull ParserDescriptor<C,Double>	doubleParser(double minValue)	Creates a new double parser using DEFAULT_MAXIMUM as the maximum value.
static <C> @NonNull ParserDescriptor<C,Double>	doubleParser(double minValue, double maxValue)	Creates a new double parser.
boolean	hasMax()	Returns whether this parser has a maximum value set.
boolean	hasMin()	Returns whether this parser has a minimum value set.
@NonNull ArgumentParseResult<Double>	parse(@NonNull CommandContext<C> commandContext, @NonNull CommandInput commandInput)	Attempts to parse the input into an object of type ArgumentParser.

Methods inherited from class org.incendo.cloud.parser.standard.NumberParser

range

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.incendo.cloud.parser.ArgumentParser

flatMap, flatMapSuccess, mapSuccess, parseFuture, suggestionProvider

Field Details

DEFAULT_MINIMUM

@API(status=STABLE)
public static final double DEFAULT_MINIMUM

Constant for the default/unset minimum value.

See Also:

• Constant Field Values

DEFAULT_MAXIMUM

@API(status=STABLE)
public static final double DEFAULT_MAXIMUM

Constant for the default/unset maximum value.

See Also:

• Constant Field Values

Constructor Details

DoubleParser

public DoubleParser(double min,
 double max)

Construct a new double parser

Parameters:

min - Minimum acceptable value

max - Maximum acceptable value

Method Details

doubleParser

@API(status=STABLE)
public static <C>
@NonNull ParserDescriptor<C,Double> doubleParser()

Creates a new double parser using DEFAULT_MINIMUM and DEFAULT_MAXIMUM as the limits.

Type Parameters:

C - the command sender type

Returns:

the created parser

doubleParser

@API(status=STABLE)
public static <C>
@NonNull ParserDescriptor<C,Double> doubleParser(double minValue)

Creates a new double parser using DEFAULT_MAXIMUM as the maximum value.

Type Parameters:

C - the command sender type

Parameters:

minValue - the minimum value accepted by the parser

Returns:

the created parser

doubleParser

@API(status=STABLE)
public static <C>
@NonNull ParserDescriptor<C,Double> doubleParser(double minValue,
 double maxValue)

Creates a new double parser.

Type Parameters:

C - the command sender type

Parameters:

minValue - the minimum value accepted by the parser

maxValue - the maximum value accepted by the parser

Returns:

the created parser

doubleComponent

@API(status=STABLE)
public static <C>
@NonNull CommandComponent.Builder<C,Double> doubleComponent()

Returns a CommandComponent.Builder using doubleParser() as the parser.

Type Parameters:

C - the command sender type

Returns:

the component builder

parse

public @NonNull ArgumentParseResult<Double> parse(@NonNull CommandContext<C> commandContext,
 @NonNull CommandInput commandInput)

Description copied from interface: ArgumentParser

Attempts to parse the input into an object of type ArgumentParser.

This method may be called when a command chain is being parsed for execution (using CommandExecutor.executeCommand(Object, String)) or when a command is being parsed to provide context for suggestions (using SuggestionFactory.suggest(Object, String)). It is possible to use CommandContext.isSuggestions()} to see what the purpose of the parsing is. Particular care should be taken when parsing for suggestions, as the parsing method is then likely to be called once for every character written by the command sender.

This method should never throw any exceptions under normal circumstances. Instead, if the parsing for some reason cannot be done successfully ArgumentParseResult.failure(Throwable) should be returned. This then wraps any exception that should be forwarded to the command sender.

The parser is assumed to be completely stateless and should not store any information about the command sender or the command context. Instead, information should be stored in the CommandContext.

Parameters:

commandContext - Command context

commandInput - Command Input

Returns:

Parsed command result

hasMax

public boolean hasMax()

Description copied from class: NumberParser

Returns whether this parser has a maximum value set.

In other words, whether the maximum of it's NumberParser.range() is different than the default maximum value.

Specified by:

hasMax in class NumberParser<C,Double,DoubleRange>

Returns:

whether the parser has a maximum set

hasMin

public boolean hasMin()

Description copied from class: NumberParser

Returns whether this parser has a minimum value set.

In other words, whether the minimum of it's NumberParser.range() is different than the default minimum value.

Specified by:

hasMin in class NumberParser<C,Double,DoubleRange>

Returns:

whether the parser has a minimum set