Vous êtes dans : GNU/Linux Astuces / Pages man [Section3 - Sous-fonctions]

GETOPT

Index

1. NOM
2. SYNOPSIS
3. DESCRIPTION
4. VALEUR RENVOYÉE
5. VARIABLES D'ENVIRONNEMENT
6. EXEMPLE
7. BOGUES
8. CONFORMITÉ À
9. TRADUCTION

NOM

SYNOPSIS

#include <unistd.h>

int getopt(int argc, char * const argv[],
 const char *optstring);

extern char * optarg;
extern int optind, opterr, optopt;

#define _GNU_SOURCE


#include <getopt.h>

int getopt_long (int argc, char * const argv[],
 const char * optstring,
 const struct option * longopts, int * longindex);

int getopt_long_only (int argc, char * const argv[],
 const char * optstring,
 const struct option * longopts, int * longindex);

DESCRIPTION

struct option {
const char *name;
int has_arg;
int *flag;
int val;
};

name

est le nom de l'option longue.

has_arg

vaut : no_argument (ou 0), si l'option ne prend pas d'argument, required_argument (ou 1) si l'option prend un argument, ou optional_argument (ou 2) si l'option prend un argument optionnel.

flag

spécifie la manière de renvoyer les résultats pour une option longue. Si flag vaut NULL, alors getopt_long() renvoie val (par exemple, le programme appelant peut remplir val avec le caractère de l'option courte correspondante). Sinon, getopt_long() renvoie 0, et flag pointe sur une variable définie à val si l'option est trouvée, mais reste inchangé si l'option est absente.

val

est la valeur à renvoyer, ou à charger dans la variable pointée par flag.

VALEUR RENVOYÉE

VARIABLES D'ENVIRONNEMENT

POSIXLY_CORRECT Si cette variable est positionnée, l'analyse s'arrête dès

qu'un argument ne constituant pas une option est rencontré.

_<PID>_GNU_nonoption_argv_flags_ Cette variable est utilisée par

bash 2.0 pour communiquer à la libc GNU quels arguments sont le résultat de l'expansion des caractères génériques, et ne doivent pas être considérés comme des options. Ce comportement a été supprimé de bash version 2.01, mais il est toujours supporté par la libc GNU.

EXEMPLE

#include <stdio.h>     /* for printf */
#include <stdlib.h>    /* for exit */
#include <getopt.h>

int
main (argc, argv)
     int argc;
     char **argv;
{
  int c;
  int digit_optind = 0;

  while (1)
    {
      int this_option_optind = optind ? optind : 1;
      int option_index = 0;
      static struct option long_options[] =
      {
        {"add", 1, 0, 0},
        {"append", 0, 0, 0},
        {"delete", 1, 0, 0},
        {"verbose", 0, 0, 0},
        {"create", 1, 0, 'c'},
        {"file", 1, 0, 0},
        {0, 0, 0, 0}
      };

      c = getopt_long (argc, argv, "abc:d:012",
                       long_options, &option_index);
      if (c == -1)
        break;

      switch (c)
        {
        case 0:
          printf ("option %s", long_options[option_index].name);
          if (optarg)
            printf (" avec argument %s", optarg);
          printf ("
");
          break;

        case '0':
        case '1':
        case '2':
          if (digit_optind != 0 && digit_optind != this_option_optind)
            printf ("chiffre dans deux arguments.
");
          digit_optind = this_option_optind;
          printf ("option %c
", c);
          break;

        case 'a':
          printf ("option a
");
          break;

        case 'b':
          printf ("option b
");
          break;

        case 'c':
          printf ("option c de valeur '%s'
", optarg);
          break;

        case 'd':
          printf ("option d de valeur '%s'
", optarg);
          break;

        case '?':
          break;

        default:
          printf ("?? caractère de code 0%o ??
", c);
        }
    }

  if (optind < argc)
    {
      printf ("Arguments ne constituant pas des options : ");
      while (optind < argc)
      printf ("%s ", argv[optind++]);
      printf ("
");
    }

  exit (0);
}

BOGUES

CONFORMITÉ À

getopt() :

POSIX.2 et POSIX.1-2001, à condition que la variable d'environnement POSIXLY_CORRECT soit positionnée. Sinon, les éléments de argv ne sont pas vraiment constants puisque l'on peut les permuter. On les déclare « const » dans le prototype pour être compatible avec d'autres systèmes.
Sur certaines anciennes implémentations, getopt() était déclarée dans <stdio.h>. SUSv1 permettait que la déclaration apparaisse soit dans <unistd.h> ou soit dans <stdio.h>. POSIX.1-2001 marque l'utilisation de <stdio.h> comme « LEGACY ». POSIX.1-2001 ne permet pas que la déclaration soit dans <stdio.h>.

TRADUCTION