com.mchange.v2.cmdline

Class CommandLineUtils

java.lang.Object

com.mchange.v2.cmdline.CommandLineUtils

public final class CommandLineUtils
extends java.lang.Object

Method Summary

Modifier and Type	Method and Description
static ParsedCommandLine	parse(java.lang.String[] argv, java.lang.String switchPrefix, java.lang.String[] validSwitches, java.lang.String[] requiredSwitches, java.lang.String[] argSwitches) "Parses" a command line by making use several conventions: Certain arguments are considered "switches", by virtue of being prefixed with some string, usually "-", "/", or "--" Switches may have arguments associated with them.

Methods inherited from class java.lang.Object

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

Method Detail

parse

public static ParsedCommandLine parse(java.lang.String[] argv,
                                      java.lang.String switchPrefix,
                                      java.lang.String[] validSwitches,
                                      java.lang.String[] requiredSwitches,
                                      java.lang.String[] argSwitches)
                               throws BadCommandLineException

"Parses" a command line by making use several conventions:

• Certain arguments are considered "switches", by virtue of being prefixed with some string, usually "-", "/", or "--"
• Switches may have arguments associated with them. This implementation permits only a single argument per switch
• Switch arguments are determined via two conventions:
  1. If a switch is of the form "--switch=value" (where "--" is set as the switch prefix), value is the switches argument.
  2. If a switch is not of this form (simply "--switch"), then the following item on the command line is considered the switch's argument if and only if
     1. the argSwitches array contains the switch, and
     2. the next item on the command line is not itself a switch

Parameters:

argv - the entire list of arguments, usually the argument to a main function

switchPrefix - the string which separates "switches" from regular command line args. Must be non-null

validSwitches - a list of all the switches permissible for this command line. If non-null, an UnexpectedSwitchException will be thrown if a switch not in this list is encountered. Use null to accept any switches.

requiredSwitches - a list of all the switches required by this command line. If non-null, an MissingSwitchException will be thrown if a switch in this list is not present. Use null if no switches should be considered required.

argSwitches - a list of switches that should have an argument associated with them If non-null, an MissingSwitchArgumentException will be thrown if a switch in this list has no argument is not present. Use null if no switches should be considered to require arguments. However, this parameter is required if distinct items on a command line should be considered arguments to preceding items. (For example, "f" must be an argSwitch for "-f myfile.txt" to be parsed as switch and argument, but argSwitches is not required to parse "--file=myfile.txt"

Throws:

BadCommandLineException