This module is a modified version of the module
System.Console.GetOpt
by Sven Panne from the ghc-base package.
It has been adapted for Curry by Bjoern Peemoeller
(c) Sven Panne 2002-2005 The Glasgow Haskell Compiler License
Copyright 2004, The University Court of the University of Glasgow. All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
this list of conditions and the following disclaimer.
this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
used to endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE UNIVERSITY COURT OF THE UNIVERSITY OF GLASGOW AND THE CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE UNIVERSITY COURT OF THE UNIVERSITY OF GLASGOW OR THE CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
data ArgOrder a
To hopefully illuminate the role of the different data structures, here are the command-line options for a (very simple) compiler, done in two different ways. The difference arises because the type of getOpt is parameterized by the type of values derived from flags. A type to describe what to do with options following non-options.
Constructors:
RequireOrder
:: ArgOrder a
no option processing after first non-option
Permute
:: ArgOrder a
freely intersperse options and non-options
ReturnInOrder
:: (String -> a) -> ArgOrder a
wrap non-options into options
data OptDescr a
Each OptDescr
describes a single option.
The arguments to Option
are:
--
)
Constructors:
Option
:: String -> [String] -> (ArgDescr a) -> String -> OptDescr a
description of a single options:
data ArgDescr a
Describes whether an option takes an argument or not, and if so how the argument is injected into a value of type @a@.
Constructors:
NoArg
:: a -> ArgDescr a
no argument expected
ReqArg
:: (String -> a) -> String -> ArgDescr a
option requires argument
OptArg
:: (Maybe String -> a) -> String -> ArgDescr a
optional argument
usageInfo
:: String -> [OptDescr a] -> String
Return a string describing the usage of a command, derived from the header (first argument) and the options described by the second argument.
:: String
|
|
-> [OptDescr a]
|
header |
-> String
|
option descriptors |
getOpt
:: ArgOrder a -> [OptDescr a] -> [String] -> ([a], [String], [String])
Process the command-line and return the list of values that matched (and those that did not match). The arguments are:
System.Environment.getArgs
).
getOpt
returns a triple consisting of the option arguments, a list
of non-options, and a list of error messages.
:: ArgOrder a
|
|
-> [OptDescr a]
|
non-option handling |
-> [String]
|
option descriptors |
-> ([a], [String], [String])
|
the command-line arguments |
getOpt'
:: ArgOrder a -> [OptDescr a] -> [String] -> ([a], [String], [String], [String])
This is almost the same as getOpt but returns a quadruple consisting of the option arguments, a list of non-options, a list of unrecognized options, and a list of error messages.
:: ArgOrder a
|
|
-> [OptDescr a]
|
non-option handling |
-> [String]
|
option descriptors |
-> ([a], [String], [String], [String])
|
the command-line arguments |