Package org.apache.commons.cli
Class Options
java.lang.Object
org.apache.commons.cli.Options
- All Implemented Interfaces:
Serializable
Main entry-point into the library.
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 commandline, 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 instanceaddOptionGroup(OptionGroup group) 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 theOptionmatching the long or short name specified.getOptionGroup(Option opt) Gets the OptionGroup theoptbelongs to.Gets a read-only list of options in this setList<?>Gets the required options.booleanhasLongOption(String opt) booleanbooleanhasShortOption(String opt) toString()Dump state, suitable for debugging.
-
Constructor Details
-
Options
public Options()
-
-
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 signalling if an argument is required after this optiondescription- 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 signalling if an argument is required after this optiondescription- Self-documenting description- Returns:
- the resulting Options instance
-
addOptionGroup
Adds the specified option group.- Parameters:
group- the OptionGroup that is to be added- Returns:
- the resulting Options instance
-
addOptions
Adds options to this option. If any Option inoptionsalready 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 signalling if an argument is required after this optiondescription- 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 theOptionmatching 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 theoptbelongs to.- Parameters:
opt- the option whose OptionGroup is being queried.- Returns:
- the OptionGroup if
optis part of an OptionGroup, otherwise return null
-
getOptions
Gets a read-only list of options in this set- Returns:
- read-only Collection of
Optionobjects in this descriptor
-
getRequiredOptions
Gets the required options.- Returns:
- read-only List of required options
-
hasLongOption
-
hasOption
-
hasShortOption
-
toString
Dump state, suitable for debugging.
-