C'de Komut Satırı Argümanları: argc, argv ve Güvenl…

Q: C'de argc ve argv nedir?

Bunlar int main(int argc, char *argv[])'nin iki parametresidir. argc, program adı dahil komut satırı argümanlarının sayısıdır; argv ise bu argümanların metin olarak dizisidir. argv[0] program adıdır, argv[1] ilk gerçek argümandır ve argv[argc] her zaman NULL'dur.

Q: Bir C programına nasıl argüman geçilir?

Terminalde çalıştırılabilir dosyanın adından sonra yazın: ./program merhaba 42. Bu argc == 3 verir; argv[1] "merhaba" metni, argv[2] ise "42" metnidir. Bu sayfadaki editörde argümanlar terminal yerine Args paneline yazılır.

Q: C'de bir komut satırı argümanı int'e nasıl dönüştürülür?

strtol kullanın: char end; long n = strtol(argv[1], &end, 10); ardından end'in hâlâ başlangıcı göstermediğini (hiçbir şey ayrıştırılmadı) ve end'in '\0' olduğunu (artık çöp yok) kontrol edin. atoi daha kısadır ama hem "0" hem "muz" için 0 döndürür, dolayısıyla hata bildiremez.

Q: C'de argv[0] nedir?

Programın çağrıldığı isim - genellikle ./program ya da tam yol. Kullanım mesajlarında (fprintf(stderr, "kullanim: %s DOSYA\n", argv[0])) işe yarar, böylece mesaj kullanıcının onu gerçekten nasıl çağırdığıyla eşleşir. Sıra dışı durumlarda boş bir metin olabilir, o yüzden var olduğunu varsaymayın.

Terminalden çalıştırdığınız her programa argüman verilebilir: gcc -Wall hello.c -o hello dört tane geçirir. Kendi C programlarınız kendilerininkini main üzerindeki iki parametreden okur ve mekanizmanın tamamı budur - kütüphane çağrısı yok, kurulum yok.

İmza

Şimdiye kadar bu belgelerdeki her örnek int main(void) kullandı. Diğer standart biçim komut satırını alır:

int main(int argc, char *argv[]) {
    /* ... */
}

argc ("argument count"), program adı dahil kaç argüman olduğudur.
argv ("argument vector"), bir metin dizisidir. char *argv[], "char'a göstericilerden oluşan dizi" demektir ki bu bir C metinleri dizisidir.

char **argv da aynı sıklıkta göreceğiniz eşdeğer bir yazımdır; dizi parametreleri göstericiye dönüşür, dolayısıyla ikisi aynı şeyi bildirir.

#include <stdio.h>

int main(int argc, char *argv[]) {
    printf("argc = %d\n", argc);

    for (int i = 0; i < argc; i++) {
        printf("argv[%d] = \"%s\"\n", i, argv[i]);
    }

    printf("argv[%d] = %s\n", argc, argv[argc] == NULL ? "NULL" : "NULL degil");
    return 0;
}

Argüman vermek için editörün Args panelini kullanın (her alan bir argümandır), sonra Çalıştır'a basın. Üç alan deneyin: merhaba, dunya, 42.

Anatomi

./greet Ada Lovelace çalıştırmak şunu üretir:

İndeks	Değer
`argv[0]`	`"./greet"`	çağrıldığı hâliyle program adı
`argv[1]`	`"Ada"`	ilk gerçek argüman
`argv[2]`	`"Lovelace"`	ikinci gerçek argüman
`argv[3]`	`NULL`	sonlandırıcı
`argc`	`3`	`argv[0]` dahil sayı

Akılda tutulmaya değer dört olgu:

argc pratikte en az 1'dir, çünkü argv[0] program adıdır. Gerçek argümanlar 1. indeksten başlar; onlar üzerindeki döngülerin i = 1'den başlamasının sebebi budur.
Her şey bir metindir. ./prog 42 size iki karakterden oluşan "42"'yi verir, asla 42 sayısını değil. Dönüştürmek sizin işiniz.
argv[argc], NULL'dur. Standart bunu garanti eder, dolayısıyla isterseniz diziyi argc olmadan dolaşabilirsiniz: for (char **p = argv + 1; *p != NULL; p++).
Kelimeleri kabuk böler, programınız değil. ./prog "Ada Lovelace" tek bir argümandır; tırnaklar kabuk tarafından tüketilir ve argv'ye hiç ulaşmaz.

Okumadan Önce Kontrol Etmek

Geçirilmemiş bir argüman boş bir metin değildir - dokunmaya hakkınız olmayan bellektir. Her zaman önce argc'yi doğrulayın:

#include <stdio.h>

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

    printf("Merhaba, %s!\n", argv[1]);
    return 0;
}

O minik programda iki gelenek var, ikisi de Unix araçlarında standart:

Kullanım mesajı stdout'a değil stderr'e gider, böylece bir yere borulanan çıktıyı kirletmez.
main'den sıfırdan farklı bir dönüş, programı çalıştıran her neyse ona başarısızlığı bildirir. 0 başarı demektir; başka her şey bir şeylerin ters gittiğini. Kabuk betikleri bunu kontrol eder.

Sabit yazılmış bir isim yerine argv[0] yazdırmak, program yeniden adlandırılmış ya da farklı bir yoldan erişilmiş olsa bile mesajın kullanıcının programı çağırma biçimiyle eşleşmesi demektir.

Sayısal Argümanları Dönüştürmek

argv[1] metindir. Aritmetik yapmak için onu dönüştürmeniz gerekir ve kullanılacak fonksiyon <stdlib.h>'deki strtol'dür:

#include <stdio.h>
#include <stdlib.h>
#include <errno.h>
#include <limits.h>

/* Basarida 1 dondurur ve degeri saklar; metin temiz bir tam sayi degilse 0. */
int parse_int(const char *text, long *out) {
    char *end;
    errno = 0;
    long value = strtol(text, &end, 10);

    if (end == text)        return 0;   /* hic rakam yok       */
    if (*end != '\0')       return 0;   /* sonda cop: "12abc"  */
    if (errno == ERANGE)    return 0;   /* long'un araligi disi */

    *out = value;
    return 1;
}

int main(int argc, char *argv[]) {
    if (argc < 2) {
        fprintf(stderr, "kullanim: %s SAYI...\n", argv[0]);
        return 1;
    }

    long total = 0;
    for (int i = 1; i < argc; i++) {
        long n;
        if (!parse_int(argv[i], &n)) {
            fprintf(stderr, "%s: tam sayi degil: %s\n", argv[0], argv[i]);
            return 1;
        }
        total += n;
    }

    printf("toplam = %ld\n", total);
    return 0;
}

10, 20 ve 30 değerlerini üç ayrı Args alanı olarak ekleyin, sonra hata yolunu görmek için birini muz ile değiştirin.

strtol'ün üçüncü parametresi tabandır: ondalık için 10, on altılık için 16 ya da bir 0x veya baştaki sıfır önekinden otomatik algılamak için 0. İkincisi, tüketmediği ilk karaktere giden bir göstericinin nereye saklanacağıdır ve hata denetimini mümkün kılan da budur:

end == text, hiçbir şey ayrıştırmadı demektir - argüman bir sayıyla başlamadı.
*end != '\0', sayıdan sonra artık metin vardı demektir, dolayısıyla "12abc" sessizce 12 olmak yerine reddedilir.
errno == ERANGE, değerin long'u taşırdığı anlamına gelir.

Daha kısa olan ve bunların hiçbirini bildiremeyen atoi ile karşılaştırın:

int n = atoi(argv[1]);   /* "muz" -> 0, "0" -> 0, taşma -> tanımsız */

atoi geçersiz girdi için 0 döndürür ki bu gerçek bir sıfırdan ayırt edilemez. Girdi programınızın dışından geldiğinde strtol (ve kayan nokta için strtod) kullanın. Daha fazlası metin dönüşümü sayfasında.

Küçük Bir Hesap Makinesi

Hepsini bir araya getirelim - bir sayı, bir operatör ve bir sayı alan bir program:

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

int parse_double(const char *text, double *out) {
    char *end;
    double v = strtod(text, &end);
    if (end == text || *end != '\0') {
        return 0;
    }
    *out = v;
    return 1;
}

int main(int argc, char *argv[]) {
    if (argc != 4) {
        fprintf(stderr, "kullanim: %s SAYI OPERATOR SAYI\n", argv[0]);
        fprintf(stderr, "  operatorler: + - x /   (kabuk dokunmasin diye * degil x)\n");
        return 1;
    }

    double a, b;
    if (!parse_double(argv[1], &a) || !parse_double(argv[3], &b)) {
        fprintf(stderr, "%s: iki islenen de sayi olmali\n", argv[0]);
        return 1;
    }

    const char *op = argv[2];
    double result;

    if      (strcmp(op, "+") == 0) result = a + b;
    else if (strcmp(op, "-") == 0) result = a - b;
    else if (strcmp(op, "x") == 0) result = a * b;
    else if (strcmp(op, "/") == 0) {
        if (b == 0.0) {
            fprintf(stderr, "%s: sifira bolme\n", argv[0]);
            return 1;
        }
        result = a / b;
    } else {
        fprintf(stderr, "%s: bilinmeyen operator \"%s\"\n", argv[0], op);
        return 1;
    }

    printf("%g\n", result);
    return 0;
}

12 + 30, sonra 7 x 6, sonra 5 / 0 deneyin.

op == "+" yerine strcmp(op, "+") == 0 olduğuna dikkat edin. char * değerlerini == ile karşılaştırmak içerikleri değil adresleri karşılaştırır ve aynı metin için bile yanlış olurdu. Bkz. metin fonksiyonları.

* yerine x gerçek hayattan bir ayrıntıdır: çoğu kabuk, programınız daha çalışmadan önce çıplak bir *'ı geçerli dizindeki dosya listesine genişletir. Tırnak içine almak ('*') da işe yarar, ama kabuğun yok saydığı bir karakter seçmek daha dostçadır.

Bayrakları Ayrıştırmak

Seçenekler geleneksel olarak - ile başlar. Basit, elle yazılmış bir döngü yaygın durumları halleder:

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

int main(int argc, char *argv[]) {
    int verbose = 0;
    long count = 1;
    const char *message = NULL;

    for (int i = 1; i < argc; i++) {
        if (strcmp(argv[i], "-v") == 0 || strcmp(argv[i], "--verbose") == 0) {
            verbose = 1;
        } else if (strcmp(argv[i], "-n") == 0) {
            if (i + 1 >= argc) {                 /* deger var olmali */
                fprintf(stderr, "%s: -n bir sayi ister\n", argv[0]);
                return 1;
            }
            count = strtol(argv[++i], NULL, 10); /* sonraki argumani tuket */
        } else if (argv[i][0] == '-') {
            fprintf(stderr, "%s: bilinmeyen secenek %s\n", argv[0], argv[i]);
            return 1;
        } else {
            message = argv[i];
        }
    }

    if (message == NULL) {
        fprintf(stderr, "kullanim: %s [-v] [-n SAYI] MESAJ\n", argv[0]);
        return 1;
    }

    if (verbose) {
        printf("\"%s\" %ld kez yazdiriliyor\n", message, count);
    }
    for (long i = 0; i < count; i++) {
        printf("%s\n", message);
    }
    return 0;
}

Dört Args alanıyla deneyin: -v, -n, 3, merhaba.

argv[++i]'den önceki i + 1 >= argc kontrolü önemli satırdır: değer bekleyen bir seçenek, değerin gerçekten orada olduğunu doğrulamalıdır, yoksa son argüman olarak -n dizinin sonunun ötesini okur. Gerçek Unix sistemlerinde <unistd.h>'deki getopt bunların hepsini sizin için yapar, -vn3 gibi birleştirilmiş kısa seçenekler dahil; bir programın ikiden üçten fazla bayrağı olduğunda ona uzanmaya değer.

Tarayıcı Editöründe Argümanlar

Bu sayfadaki editör blokları sizin için derlenip çalıştırılır ve Args paneli, bir terminalde program adından sonra yazacaklarınızı yazdığınız yerdir. Add arg ile eklediğiniz her alan, tam olarak argv'de tek bir kayıt olur - arada bir kabuk yoktur, dolayısıyla hiçbir şey boşluklardan bölünmez ve tırnak gerekmez: merhaba dunya içeren bir alan, tek bir merhaba dunya argümanı olarak gelir. -n 3 merhaba geçirmek için üç alan ekleyin. Paneli boş bırakmak argc == 1 verir - argc < 2 korumasının ilk çalıştırmada devreye girmesinin ve onu yazmaya değmesinin sebebi budur.

Sık Yapılan Hatalar

argc'yi kontrol etmeden argv[1]'i okumak. Hiç argüman geçirilmediğinde tanımsız davranıştır - ve bu alandaki en yaygın çökme.
Döngüyü i = 0'dan başlatmak. Bu, program adını veriymiş gibi işler.
argv[1]'i sayı olarak görmek. Siz dönüştürene kadar metindir.
Kullanıcı girdisinde atoi kullanmak. Kötü bir argümanı sıfırdan ayırt etmenin yolu yoktur.
Metinleri == ile karşılaştırmak. strcmp kullanın.
argv metinlerinin içine yazmak. Onları değiştirmeye standart izin verir ama alan sınırlı ve platforma bağlıdır; bir şeyi değiştirmeniz gerekiyorsa kendi tamponunuza kopyalayın.

Sıkça Sorulan Sorular

C'de argc ve argv nedir?

Bunlar int main(int argc, char *argv[])'nin iki parametresidir. argc, program adı dahil komut satırı argümanlarının sayısıdır; argv ise bu argümanların metin olarak dizisidir. argv[0] program adıdır, argv[1] ilk gerçek argümandır ve argv[argc] her zaman NULL'dur.

Bir C programına nasıl argüman geçilir?

Terminalde çalıştırılabilir dosyanın adından sonra yazın: ./program merhaba 42. Bu argc == 3 verir; argv[1] "merhaba" metni, argv[2] ise "42" metnidir. Bu sayfadaki editörde argümanlar terminal yerine Args paneline yazılır.

C'de bir komut satırı argümanı int'e nasıl dönüştürülür?

strtol kullanın: char *end; long n = strtol(argv[1], &end, 10); ardından end'in hâlâ başlangıcı göstermediğini (hiçbir şey ayrıştırılmadı) ve *end'in '\0' olduğunu (artık çöp yok) kontrol edin. atoi daha kısadır ama hem "0" hem "muz" için 0 döndürür, dolayısıyla hata bildiremez.

C'de argv[0] nedir?

Programın çağrıldığı isim - genellikle ./program ya da tam yol. Kullanım mesajlarında (fprintf(stderr, "kullanim: %s DOSYA\n", argv[0])) işe yarar, böylece mesaj kullanıcının onu gerçekten nasıl çağırdığıyla eşleşir. Sıra dışı durumlarda boş bir metin olabilir, o yüzden var olduğunu varsaymayın.

İlgili kavramlar