Package cloud.commandframework.arguments.standard

Class LongArgument.LongParser<C>

java.lang.Object
cloud.commandframework.arguments.standard.LongArgument.LongParser<C>
All Implemented Interfaces:
ArgumentParser<C,Long>
Enclosing class:
LongArgument<C>
@API(status=STABLE) public static final class LongArgument.LongParser<C> extends Object implements ArgumentParser<C,Long>

  • Field Details

    • DEFAULT_MINIMUM

      @API(status=STABLE, since="1.5.0") public static final long DEFAULT_MINIMUM
      Constant for the default/unset minimum value.
      Since:
      1.5.0
      See Also:

    • DEFAULT_MAXIMUM

      @API(status=STABLE, since="1.5.0") public static final long DEFAULT_MAXIMUM
      Constant for the default/unset maximum value.
      Since:
      1.5.0
      See Also:

  • Constructor Details

    • LongParser

      public LongParser(long min, long max)
      Construct a new long parser
      Parameters:
      min - Minimum acceptable value
      max - Maximum acceptable value

  • Method Details

    • parse

      public @NonNull ArgumentParseResult<Long> parse(@NonNull CommandContext<C> commandContext, @NonNull Queue<@NonNull String> inputQueue)
      Description copied from interface: ArgumentParser
      Parse command input into a command result.

      This method may be called when a command chain is being parsed for execution (using CommandManager.executeCommand(Object, String)) or when a command is being parsed to provide context for suggestions (using CommandManager.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.

      Specified by:
      parse in interface ArgumentParser<C,Long>
      Parameters:
      commandContext - Command context
      inputQueue - The queue of arguments
      Returns:
      Parsed command result

    • getMin

      public long getMin()
      Get the minimum value accepted by this parser
      Returns:
      Min value

    • getMax

      public long getMax()
      Get the maximum value accepted by this parser
      Returns:
      Max value

    • hasMax

      @API(status=STABLE, since="1.5.0") public boolean hasMax()
      Get whether this parser has a maximum set. This will compare the parser's maximum to DEFAULT_MAXIMUM.
      Returns:
      whether the parser has a maximum set
      Since:
      1.5.0

    • hasMin

      @API(status=STABLE, since="1.5.0") public boolean hasMin()
      Get whether this parser has a minimum set. This will compare the parser's minimum to DEFAULT_MINIMUM.
      Returns:
      whether the parser has a maximum set
      Since:
      1.5.0

    • isContextFree

      public boolean isContextFree()
      Description copied from interface: ArgumentParser
      Check whether this argument parser is context free. A context free parser will not use the provided command context, and so supports impromptu parsing
      Specified by:
      isContextFree in interface ArgumentParser<C,Long>
      Returns:
      true if the parser is context free, else false

    • suggestions

      public @NonNull List<@NonNull String> suggestions(@NonNull CommandContext<C> commandContext, @NonNull String input)
      Description copied from interface: ArgumentParser
      Get a list of suggested arguments that would be correctly parsed by this parser

      This method is likely to be called for every character provided by the sender and so it may be necessary to cache results locally to prevent unnecessary computations

      Specified by:
      suggestions in interface ArgumentParser<C,Long>
      Parameters:
      commandContext - Command context
      input - Input string
      Returns:
      List of suggestions