Class Options
- All Implemented Interfaces:
Serializable
Options represents a collection of Option
objects, which describe the possible options for a command-line.
It may flexibly parse long and short options, with or without values. Additionally, it may parse only a portion of a command-line, allowing for flexible multi-stage parsing.
- See Also:
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionAdds an option that only contains a short-name.Adds an option that only contains a short name.Adds an option that contains a short-name and a long-name.Adds an option instance.addOptionGroup
(OptionGroup optionGroup) Adds the specified option group.addOptions
(Options options) Adds options to this option.addRequiredOption
(String opt, String longOpt, boolean hasArg, String description) Adds an option that contains a short-name and a long-name.getMatchingOptions
(String opt) Gets the options with a long name starting with the name specified.Gets theOption
matching the long or short name specified.getOptionGroup
(Option option) Gets the OptionGroup theopt
belongs to.Gets a read-only list of options in this set.List
<?> Gets the required options.boolean
hasLongOption
(String opt) boolean
boolean
hasShortOption
(String opt) toString()
Dump state, suitable for debugging.
-
Constructor Details
-
Options
public Options()Constructs new instance.
-
-
Method Details
-
addOption
Adds an option instance.- Parameters:
opt
- the option that is to be added.- Returns:
- the resulting Options instance.
-
addOption
Adds an option that only contains a short-name.It may be specified as requiring an argument.
- Parameters:
opt
- Short single-character name of the option.hasArg
- flag signaling if an argument is required after this option.description
- Self-documenting description.- Returns:
- the resulting Options instance.
-
addOption
Adds an option that only contains a short name.The option does not take an argument.
- Parameters:
opt
- Short single-character name of the option.description
- Self-documenting description.- Returns:
- the resulting Options instance.
- Since:
- 1.3
-
addOption
Adds an option that contains a short-name and a long-name.It may be specified as requiring an argument.
- Parameters:
opt
- Short single-character name of the option.longOpt
- Long multi-character name of the option.hasArg
- flag signaling if an argument is required after this option.description
- Self-documenting description.- Returns:
- the resulting Options instance.
-
addOptionGroup
Adds the specified option group.An Option cannot be required if it is in an
OptionGroup
, either the group is required or nothing is required. This means thatOption
in the given group are set to optional.- Parameters:
optionGroup
- the OptionGroup that is to be added.- Returns:
- the resulting Options instance.
-
addOptions
Adds options to this option. If any Option inoptions
already exists in this Options an IllegalArgumentException is thrown.- Parameters:
options
- the options to add.- Returns:
- The resulting Options instance.
- Since:
- 1.7.0
-
addRequiredOption
Adds an option that contains a short-name and a long-name.The added option is set as required. It may be specified as requiring an argument. This method is a shortcut for:
Options option = new Option(opt, longOpt, hasArg, description); option.setRequired(true); options.add(option);
- Parameters:
opt
- Short single-character name of the option.longOpt
- Long multi-character name of the option.hasArg
- flag signaling if an argument is required after this option.description
- Self-documenting description.- Returns:
- the resulting Options instance.
- Since:
- 1.4
-
getMatchingOptions
Gets the options with a long name starting with the name specified.- Parameters:
opt
- the partial name of the option.- Returns:
- the options matching the partial name specified, or an empty list if none matches.
- Since:
- 1.3
-
getOption
Gets theOption
matching the long or short name specified.The leading hyphens in the name are ignored (up to 2).
- Parameters:
opt
- short or long name of theOption
.- Returns:
- the option represented by opt.
-
getOptionGroup
Gets the OptionGroup theopt
belongs to.- Parameters:
option
- the option whose OptionGroup is being queried.- Returns:
- the OptionGroup if
opt
is part of an OptionGroup, otherwise return null.
-
getOptions
Gets a read-only list of options in this set.- Returns:
- read-only Collection of
Option
objects in this descriptor.
-
getRequiredOptions
Gets the required options.- Returns:
- read-only List of required options.
-
hasLongOption
-
hasOption
-
hasShortOption
-
toString
Dump state, suitable for debugging.
-