Module System.Console.GetOpt

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.

Summary of exported operations:

usageInfo :: String -> [OptDescr a] -> String  Deterministic 
getOpt :: ArgOrder a -> [OptDescr a] -> [String] -> ([a],[String],[String])  Deterministic 
Process the command-line and return the list of values that matched (and those that did not match).
getOpt' :: ArgOrder a -> [OptDescr a] -> [String] -> ([a],[String],[String],[String])  Deterministic 
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.

Exported datatypes:

ArgOrder

A type to describe what to do with options following non-options.

Constructors:

  • RequireOrder :: ArgOrder a
  • Permute :: ArgOrder a
  • ReturnInOrder :: (String -> a) -> ArgOrder a
OptDescr

Each OptDescr describes a single option.

The arguments to Option are:

  • list of short option characters
  • list of long option strings (without --)
  • argument descriptor
  • explanation of option for user

Constructors:

  • Option :: String -> [String] -> (ArgDescr a) -> String -> OptDescr a
ArgDescr

Constructors:

  • NoArg :: a -> ArgDescr a
  • ReqArg :: (String -> a) -> String -> ArgDescr a
  • OptArg :: (Maybe String -> a) -> String -> ArgDescr a

Exported operations:

usageInfo :: String -> [OptDescr a] -> String  Deterministic 

getOpt :: ArgOrder a -> [OptDescr a] -> [String] -> ([a],[String],[String])  Deterministic 

Process the command-line and return the list of values that matched (and those that did not match). The arguments are:

  • The order requirements (see ArgOrder)
  • The option descriptions (see OptDescr)
  • The actual command line arguments (presumably got from System.Environment.getArgs).

getOpt returns a triple consisting of the option arguments, a list of non-options, and a list of error messages.

getOpt' :: ArgOrder a -> [OptDescr a] -> [String] -> ([a],[String],[String],[String])  Deterministic 

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.