www.delorie.com/gnu/docs/guile/guile_30.html

search

	Buy GNU books!

Guile Reference Manual

10.2 The (ice-9 getopt-long) Module

A script is free to parse and handle its command line arguments in any way that it chooses. Where the set of possible options and arguments is complex, however, it can get tricky to extract all the options, check the validity of given arguments, and so on. This task can be greatly simplified by taking advantage of the module (ice-9 getopt-long), which is distributed with Guile.

The (ice-9 getopt-long) module exports two procedures: getopt-long and option-ref.

• getopt-long takes a list of strings -- the command line arguments -- and an option specification. It parses the command line arguments according to the option specification and returns a data structure that encapsulates the results of the parsing.

• option-ref then takes the parsed data structure and a specific option's name, and returns information about that option in particular.

To make these procedures available to your Guile script, include the expression (use-modules (ice-9 getopt-long)) somewhere near the top, before the first usage of getopt-long or option-ref.

10.2.1 A Short getopt-long Example		A short getopt-long example.
10.2.2 How to Write an Option Specification		How to write an option specification.
10.2.3 Expected Command Line Format		The expected command line format.
10.2.4 Reference Documentation for getopt-long		Full documentation for getopt-long.
10.2.5 Reference Documentation for option-ref		Full documentation for option-ref.