joptsimple
Class OptionSet

java.lang.Object
  extended by joptsimple.OptionSet

public class OptionSet
extends java.lang.Object

Representation of a group of detected command line options, their arguments, and non-option arguments.


Method Summary
 boolean equals(java.lang.Object that)
          
 boolean has(OptionSpec<?> option)
          Tells whether the given option was detected.
 boolean has(java.lang.String option)
          Tells whether the given option was detected.
 boolean hasArgument(OptionSpec<?> option)
          Tells whether there are any arguments associated with the given option.
 boolean hasArgument(java.lang.String option)
          Tells whether there are any arguments associated with the given option.
 int hashCode()
          
 java.util.List<java.lang.String> nonOptionArguments()
           
<V> V
valueOf(OptionSpec<V> option)
          Gives the argument associated with the given option.
 java.lang.Object valueOf(java.lang.String option)
          Gives the argument associated with the given option.
<V> java.util.List<V>
valuesOf(OptionSpec<V> option)
          Gives any arguments associated with the given option.
 java.util.List<?> valuesOf(java.lang.String option)
          Gives any arguments associated with the given option.
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

has

public boolean has(java.lang.String option)

Tells whether the given option was detected.

Parameters:
option - the option to search for
Returns:
true if the option was detected
See Also:
has(OptionSpec)

has

public boolean has(OptionSpec<?> option)

Tells whether the given option was detected.

This method recognizes only instances of options returned from the fluent interface methods.

Parameters:
option - the option to search for
Returns:
true if the option was detected
See Also:
has(String)

hasArgument

public boolean hasArgument(java.lang.String option)

Tells whether there are any arguments associated with the given option.

Parameters:
option - the option to search for
Returns:
true if the option was detected and at least one argument was detected for the option

hasArgument

public boolean hasArgument(OptionSpec<?> option)

Tells whether there are any arguments associated with the given option.

This method recognizes only instances of options returned from the fluent interface methods.

Parameters:
option - the option to search for
Returns:
true if the option was detected and at least one argument was detected for the option

valueOf

public java.lang.Object valueOf(java.lang.String option)

Gives the argument associated with the given option. If the option was given an argument type, the argument will take on that type; otherwise, it will be a String.

Parameters:
option - the option to search for
Returns:
the argument of the given option; null if no argument is present, or that option was not detected
Throws:
OptionException - if more than one argument was detected for the option

valueOf

public <V> V valueOf(OptionSpec<V> option)

Gives the argument associated with the given option.

This method recognizes only instances of options returned from the fluent interface methods.

Type Parameters:
V - represents the type of the arguments the given option accepts
Parameters:
option - the option to search for
Returns:
the argument of the given option; null if no argument is present, or that option was not detected
Throws:
OptionException - if more than one argument was detected for the option
java.lang.ClassCastException - if the arguments of this option are not of the expected type

valuesOf

public java.util.List<?> valuesOf(java.lang.String option)

Gives any arguments associated with the given option. If the option was given an argument type, the arguments will take on that type; otherwise, they will be Strings.

Parameters:
option - the option to search for
Returns:
the arguments associated with the option, as a list of objects of the type given to the arguments; an empty list if no such arguments are present, or if the option was not detected

valuesOf

public <V> java.util.List<V> valuesOf(OptionSpec<V> option)

Gives any arguments associated with the given option. If the option was given an argument type, the arguments will take on that type; otherwise, they will be Strings.

This method recognizes only instances of options returned from the fluent interface methods.

Type Parameters:
V - represents the type of the arguments the given option accepts
Parameters:
option - the option to search for
Returns:
the arguments associated with the option; an empty list if no such arguments are present, or if the option was not detected
Throws:
OptionException - if there is a problem converting the option's arguments to the desired type; for example, if the type does not implement a correct conversion constructor or method

nonOptionArguments

public java.util.List<java.lang.String> nonOptionArguments()
Returns:
the detected non-option arguments

equals

public boolean equals(java.lang.Object that)

Overrides:
equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:
hashCode in class java.lang.Object