Documentation>C API
getopt_long.c File Reference

getopt_long - Definition More...

#include <stdlib.h>
#include <string.h>
#include <stdio.h>
#include "generic.h"
#include "getopt_long.h"


int getopt_long (int argc, char *const argv[], const char *optstring, const struct option *longopts, int *longindex)
 Parse long options (BSD style) More...

Detailed Description

Andrea Vedaldi

Function Documentation

◆ getopt_long()

int getopt_long ( int  argc,
char *const  argv[],
const char *  optstring,
const struct option longopts,
int *  longindex 
argcnumber of arguments.
argvpointer to the vector of arguments.
optstringlist of abbreviated options
longoptslist of long options.
longindexindex of current option in longopts.
the code of the next option.

This function extract long and short options from the argument list argv of argc entries.

A short options sequence is introduced by a single dash character -. Each short option is described by a single character in the string optstring, possibly followed by a : character to denote a (mandatory) argument of the short option. A short option with an argument cannot appear in the middle of a short option sequence, but only at the end.

A long option is introduced by a double dash . Each long option is described by an instance of the option structure in the longopts table (the last entry must be filled with zeroes to denote the end).

Illegal options and missing arguments cause the function to skip the option and return '?'. If opterr is true (default), the function prints an error message to stderr. Finally, if optstring has a leading :, then error messages are suppressed and a missing argument causes : to be returned.

The function is currently not thread safe.