C Academy · Lektion

Bygg ett CLI-verktyg

Praktiskt exempel.

Lektion 4 av 413 steg

Bygg ett CLI-verktyg är en gratis lektion i C Academy på CoddyKit. Detta är lektion 4 av 4. Ni kan läsa hela lektionen gratis nedan och sedan öva praktiskt i webbläsaren med en inbyggd kodredigerare och en AI-handledare som är tillgänglig dygnet runt. Den ingår i lärvägen för C Academy, och Era framsteg synkroniseras mellan webben och CoddyKit-appen. Kursen i C Academy innehåller totalt 4 lektioner.

Sätt ihop allt

Nu kombinerar vi argument, alternativ och tolkning i ett litet men komplett CLI-verktyg.

Vårt exempel är ett verktyg för talformatering som läser in ett värde och några alternativ och sedan skriver ut ett resultat.

#include <stdio.h>

int main(int argc, char *argv[]) {
    if (argc < 2) {
        printf("Usage: %s <number>\n", argv[0]);
        return 1;
    }
    printf("You passed: %s\n", argv[1]);
    return 0;
}

Utforma gränssnittet

Bra CLI-verktyg definierar sitt gränssnitt på förhand. Vårt verktyg accepterar:

-v utförliga meddelanden
-r N upprepa utskriften N gånger
ett positionsargument: texten som ska skrivas ut

#include <stdio.h>

int main(void) {
    printf("Interface: prog [-v] [-r N] <text>\n");
    return 0;
}

Deklarera inställningar

Lägg varje konfigurerbart beteende i en variabel med ett rimligt standardvärde. Då hålls tolkningen åtskild från det faktiska arbetet.

#include <stdio.h>

int main(void) {
    int verbose = 0;
    int repeat = 1;
    const char *text = NULL;
    printf("defaults: verbose=%d repeat=%d\n", verbose, repeat);
    return 0;
}

Tolka med getopt

Använd getopt för att fylla i flaggorna. -r tar ett värde, så motsvarande post i optstring är r:.

#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>

int main(int argc, char *argv[]) {
    int verbose = 0, repeat = 1, opt;
    while ((opt = getopt(argc, argv, "vr:")) != -1) {
        if (opt == 'v') verbose = 1;
        else if (opt == 'r') repeat = atoi(optarg);
    }
    printf("verbose=%d repeat=%d\n", verbose, repeat);
    return 0;
}

Läs positionsargumentet

Efter getopt pekar optind på det första icke-alternativargumentet. Vi hämtar texten därifrån.

Om inget sådant argument finns skriver vi ut användningsinformation och avslutar med en felkod.

#include <stdio.h>
#include <unistd.h>

int main(int argc, char *argv[]) {
    while (getopt(argc, argv, "vr:") != -1) { }
    if (optind >= argc) {
        printf("Error: missing text argument\n");
        return 1;
    }
    printf("text = %s\n", argv[optind]);
    return 0;
}

Validera numerisk indata

Ett robust verktyg kontrollerar att -r fick ett rimligt tal. Avvisa upprepningsantal som är noll eller negativa.

#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>

int main(int argc, char *argv[]) {
    int repeat = 1, opt;
    while ((opt = getopt(argc, argv, "r:")) != -1) {
        if (opt == 'r') repeat = atoi(optarg);
    }
    if (repeat < 1) {
        printf("Error: repeat must be >= 1\n");
        return 1;
    }
    printf("repeat = %d\n", repeat);
    return 0;
}

Utför arbetet

När inställningarna har tolkats och validerats utför du den faktiska uppgiften. Här skriver vi ut texten repeat gånger.

#include <stdio.h>

int main(void) {
    const char *text = "hello";
    int repeat = 3;
    for (int i = 0; i < repeat; i++) {
        printf("%s\n", text);
    }
    return 0;
}

Utförlig utskrift

Den utförliga flaggan kan lägga till diagnostisk information. Villkora sådana utskrifter med flaggan så att den vanliga utskriften förblir ren.

#include <stdio.h>

int main(void) {
    int verbose = 1;
    const char *text = "hi";
    if (verbose) printf("[debug] about to print text\n");
    printf("%s\n", text);
    return 0;
}

Det kompletta verktyget

Här är hela programmet som kopplar ihop alla delar: tolka, validera och sedan köra.

#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>

int main(int argc, char *argv[]) {
    int verbose = 0, repeat = 1, opt;
    while ((opt = getopt(argc, argv, "vr:")) != -1) {
        if (opt == 'v') verbose = 1;
        else if (opt == 'r') repeat = atoi(optarg);
    }
    if (optind >= argc) { printf("Usage: prog [-v] [-r N] <text>\n"); return 1; }
    const char *text = argv[optind];
    if (verbose) printf("[debug] repeat=%d\n", repeat);
    for (int i = 0; i < repeat; i++) printf("%s\n", text);
    return 0;
}

Avslutningskoder spelar roll

CLI-verktyg kommunicerar om körningen lyckades genom sin avslutningskod. Returnera 0 vid framgång och ett värde som inte är noll vid fel.

Skript och andra program förlitar sig på detta för att avgöra vad de ska göra härnäst.

#include <stdio.h>

int main(int argc, char *argv[]) {
    if (argc < 2) {
        printf("failure\n");
        return 2;
    }
    printf("success\n");
    return 0;
}

Skriv fel till stderr

Enligt konvention går normal utskrift till stdout och fel går till stderr via fprintf(stderr, ...).

Det gör att användare kan skilja resultat från diagnostik när utskriften omdirigeras.

#include <stdio.h>

int main(int argc, char *argv[]) {
    if (argc < 2) {
        fprintf(stderr, "Error: need an argument\n");
        return 1;
    }
    printf("%s\n", argv[1]);
    return 0;
}

Snabbkontroll

Testa dina kunskaper om konventioner för CLI-verktyg.

Besvara frågan i den interaktiva lektionen

Sammanfattning

Du har byggt ett komplett CLI-verktyg:

Definiera gränssnittet och deklarera inställningar med standardvärden.
Tolka flaggor med getopt; läs positionsargument från optind.
Validera indata innan arbetet utförs.
Returnera meningsfulla avslutningskoder och skicka fel till stderr.

Gratis att börja

Lär dig C med en AI-lärare – gratis

Skriv och kör riktig kod i webbläsaren, få omedelbar hjälp av en AI-lärare dygnet runt och fortsätt där du slutade – på webben eller i appen.

Kurser: 39
Lektioner: 144

Börja lära dig gratis Visa hela kursen

Vanliga frågor

Är lektionen ”Bygg ett CLI-verktyg” gratis?

Ja – hela texten till ”Bygg ett CLI-verktyg” kan läsas gratis här på webben. Om Ni vill öva interaktivt med en inbyggd kodredigerare och en AI-handledare som är tillgänglig dygnet runt och låsa upp resten av kursen i C Academy, kan Ni uppgradera till CoddyKit PRO. Kursen i C Academy innehåller totalt 4 lektioner.

Vad lär jag mig i ”Bygg ett CLI-verktyg”?

Praktiskt exempel. Ni övar på C Academy med praktisk kod som körs direkt i webbläsaren, medan en AI-handledare som är tillgänglig dygnet runt svarar på Era frågor under lektionen.

Behöver jag någon erfarenhet för att börja lära mig C Academy?

Du behöver inga förkunskaper. Utbildningen i C Academy på CoddyKit är upplagd för allt från nybörjare till avancerade elever, så att du kan börja här eller från början och gå fram i din egen takt. Detta är lektion 4 av 4.

Hur lång tid tar lektionen ”Bygg ett CLI-verktyg”?

De flesta CoddyKit-lektioner tar cirka 5–10 minuter. Varje lektion är kort och interaktiv, så att du gör stadiga framsteg och kan fortsätta precis där du slutade – på webben eller i appen.

Kan jag skriva och köra kod i den här C Academy-lektionen?

Ja. Varje C Academy-lektion innehåller en inbyggd kodredigerare, så att du kan skriva och köra riktig kod direkt i webbläsaren och få omedelbar AI-feedback – utan lokal installation.

Alla lektioner i den här kursen

← Tillbaka till C Academy