BEZEICHNUNG¶

ÜBERSICHT¶

#include <unistd.h>

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

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

#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);

Mit Glibc erforderliche Makros (siehe feature_test_macros(7)):

getopt(): _POSIX_C_SOURCE >= 2 || _XOPEN_SOURCE
getopt_long(), getopt_long_only(): _GNU_SOURCE

BESCHREIBUNG¶

Die Variable optind ist der Index des nächsten zu verarbeitenden Elements in argv. Das System initialisiert diesen Wert mit 1. Der Aufrufende kann ihn auf 1 zurücksetzen, um das Durchsuchen des gleichen argv erneut zu beginnen oder beim Durchsuchen eines neuen Argumentenfeldes.

Falls getopt() ein weiteres Optionszeichen findet, gibt sie dieses Zeichen zurück, wobei die externe Variable optind und eine statische Variable nextchar auf neuen Stand gesetzt werden, so dass der nächste Aufruf von getopt() die Suche mit dem folgenden Optionszeichen oder argv-Element fortsetzen kann.

Falls es keine weiteren Optionszeichen gibt, gibt getopt() -1 zurück. Dann ist optind der Index des ersten argv-Elementes in argv, das keine Option ist.

optstring ist eine Zeichenkette, die die gültigen Optionszeichen enthält. Falls solch ein Zeichen von einem Doppelpunkt gefolgt wird, benötigt diese Option ein Argument, weswegen getopt() einen Zeiger auf den folgenden Text in dem selben argv-Element oder den Text des folgenden argv-Elementes in optarg platziert. Zwei Doppelpunkte bedeuten, dass diese Option ein optionales Argument erwartet; falls es Text im aktuellen argv-Element gibt, wird er in optarg zurückgegeben, anderenfalls wird optarg auf numerisch Null gesetzt. Dieses ist eine GNU-Erweiterung. Falls optstring W gefolgt von einem Semikolon enthält, wird -W foo als lange Option --foo interpretiert. (Die Option -W ist von POSIX.2 für die Implementierung von Erweiterungen reserviert.) Dieses Verhalten ist eine GNU-Erweiterung, die nicht in Bibliotheken vor GNU Glibc 2 verfügbar war.

Standardmäßig vertauscht getopt() den Inhalt von argv beim Durchsuchen, so dass schließlich alle Nichtoptionen am Ende stehen. Zwei weitere Modi sind ebenfalls implementiert. Falls das erste Zeichen von optstring ein '+' ist oder die Umgebungsvariable POSIXLY_CORRECT gesetzt ist, dann stoppt die Optionsbearbeitung sobald ein Argument auftritt, das keine Option ist. Falls das erste Zeichen von optstring ein '-' ist, dann wird jedes Argument von argv, das keine Option ist, so behandelt, als ob es Argument einer Option mit dem Zeichencode 1 wäre. (Dies wird von Programmen benutzt, die Optionen und andere argv-Elemente in beliebiger Reihenfolge erwarten, und die Wert auf die Reihenfolge der beiden legen.) Das besondere Argument »--« erzwingt die Beendigung der Suche nach Optionen unabhängig von der Suchmethode.

Beim Verarbeiten der Optionsliste kann getopt() zwei Arten von Fehler erkennen: (1) ein Optionszeichen, das nicht in optstring angegeben wurde und (2) ein fehlendes Optionsargument (d.h. eine Option am Ende der Befehlszeile ohne ein erwartetes Argument). Solche Fehler werden wie folgt verarbeitet und berichtet:

• Standardmäßig gibt getopt() eine Fehlermeldung auf der Standardfehlerausgabe aus, stellt das fehlerhafte Optionszeichen in optopt und liefert »?« as Funktionsergebnis zurück.
• Falls der Aufrufende die globale Variable opterr auf Null gesetzt hat, dann gibt getopt() keine Fehlermeldung aus. Der Aufrufende kann durch Testen, ob der Funktionsrückgabewert »?« ist, ermitteln, ob es einen Fehler gab. (Standardmäßig hat opterr einen von Null verschiedenen Wert).
• Falls das erste Zeichen im optstring (nach einem optionalen »+« oder »-« wie oben beschrieben) ein Doppelpunkt (»:«) ist, dann gibt getopt() analog auch keine Fehlermeldung aus. Zusätzlich wird es »:« statt »?« zurückliefern, um ein fehlendes Argument anzuzeigen. Dies ermöglicht es dem Aufrufenden, die zwei Arten von Fehlern zu unterscheiden.

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

RÜCKGABEWERT¶

getopt_long() und getopt_long_only() geben auch das Optionszeichen zurück, wenn eine kurze Option gefunden wurde. Für eine lange Option geben sie val zurück, wenn flag NULL ist, anderenfalls 0. Fehler- und -1-Rückgaben sind wie bei getopt(), zusätzlich jedoch '-' für eine unzureichende Übereinstimmung oder einen überzähligen Parameter.

UMGEBUNGSVARIABLEN¶

POSIXLY_CORRECT

Falls sie gesetzt ist, dann stoppt die Optionsbearbeitung, sobald ein Argument auftritt, das keine Option ist.

_<PID>_GNU_nonoption_argv_flags_

Diese Variable wurde von der bash(1)-Version 2.0 genutzt, um der Glibc mitzuteilen, welche Argumente Ergebnis der Ersetzung von Platzhaltern und somit nicht als Optionen anzusehen sind. Dieses Verhalten wurde in der bash(1)-Version 2.01 entfernt, wird aber weiterhin von der Glibc unterstützt.

ATTRIBUTE¶

KONFORM ZU¶

getopt():

POSIX.1-2001, POSIX.1-2008 und POSIX.2, vorausgesetzt, die Umgebungsvariable POSIXLY_CORRECT ist gesetzt. Anderenfalls sind die Elemente von argv nicht wirklich const, da wir sie vertauschen. Wir geben im Prototypen vor, sie seien const, um kompatibel zu anderen Systemen zu sein.

Die Verwendung von '+' und '-' in optstring ist eine GNU-Erweiterung.

In einigen älteren Implementierungen wurde getopt() in <stdio.h> deklariert. SUSv1 gestattete die Deklaration entweder in <unistd.h> oder <stdio.h>. POSIX.1-1995 kennzeichnete die Verwendung von <stdio.h> zu diesem Zweck als LEGACY. POSIX.1-2001 verlangt nicht, dass diese Deklaration in <stdio.h> enthalten ist.

getopt_long() und getopt_long_only():

Diese Funktionen sind GNU-Erweiterungen.

ANMERKUNGEN¶

BEISPIEL¶

#include <unistd.h>
#include <stdlib.h>
#include <stdio.h>
int
main(int argc, char *argv[])
{
    int flags, opt;
    int nsecs, tfnd;
    nsecs = 0;
    tfnd = 0;
    flags = 0;
    while ((opt = getopt(argc, argv, "nt:")) != -1) {
        switch (opt) {
        case 'n':
            flags = 1;
            break;
        case 't':
            nsecs = atoi(optarg);
            tfnd = 1;
            break;
        default: /* '?' */
            fprintf(stderr, "Verwendung: %s [-t nsecs] [-n] Name\n",
                    argv[0]);
            exit(EXIT_FAILURE);
        }
    }
    printf("flags=%d; tfnd=%d; nsecs=%d; optind=%d\n",
            flags, tfnd, nsecs, optind);
    if (optind >= argc) {
        fprintf(stderr,
                "Nach den Optionen wurde ein Argument erwartet\n");
        exit(EXIT_FAILURE);
    }
    printf("name argument = %s\n", argv[optind]);
    /* Weiterer Code weggelassen */
    exit(EXIT_SUCCESS);
}

SIEHE AUCH¶

KOLOPHON¶

ÜBERSETZUNG¶

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an <debian-l10n-german@lists.debian.org>.