BG MVC Model View Controller eğitim serisi yayında...

Ana sayfa > Programlama > C Programlama > C standart kütüphanesi > <stdio.h> > rename

rename() fonksiyonu

Bildirim

int rename(const char *oldname, const char *newname);

Açıklama

Bir dosyanın adını değiştirir. Oldname parametresindeki karakter dizisi ile gösterilen dosyayının adını newname parametresindeki karakter dizisi ile değiştirir.

Eğer newname ile gösterilen dosya mevcut ise, sisteme ve kütüphane uygulamalarına bağlı olarak, fonksiyon başarısız bir şekilde sonuçlanır veya mevcut dosyanın üzerine yazar.

Parametreler

oldname: Adı değiştirilecek olan dosyanın yol tanımlamasını içeren boş bir karakter ('\0') ile sonlandırılmış bir karakter dizisi işaretçisidir.

newname: Dosyanın yeni yol tanımlamasını içeren boş bir karakter ('\0') ile sonlandırılmış bir karakter dizisi işaretçisidir.

Dönüş değeri

Başarı durumunda yazılan 0 değeri, hata durumunda ise sıfır olmayan bir değer geri döndürülür.

Örnek


#include <stdio.h>

int main(void)
{
    FILE *fp;
    char cdizi[40];

    if ((fp = fopen ("dosya1.txt", "w+")) == NULL) {
         printf("Dosya açma hatası!");
         exit(1);
    }

    fputs("Bilgisayar", fp);
    fclose(fp);

    if (rename("dosya1.txt", "dosya2.txt")==0) printf("Dosya adı başarılı bir şekilde değiştirildi!");
    else perror("Dosya adı değiştirme hatası");

    if ((fp = fopen ("dosya2.txt", "a+")) == NULL) {
         printf("Dosya açma hatası!");
         exit(1);
    }

    fputs(" Programlama", fp);
    rewind(fp);

    fgets(cdizi, 40, fp);
    printf("\n%s", cdizi);

    fclose(fp);

    return 0;
}

Yukarıdaki örnekte, program aşağıdaki satırı ekrana yazar:

Dosya adı başarılı bir şekilde değiştirildi!
Bilgisayar Programlama

Yukarıdaki program, yazma ve okuma modunda açtığı dosyaya bir karakter dizisi yazar ve dosyayı kapatır. Dosyanın adını değiştirdikten sonra, dosyayı ekleme ve okuma modunda tekrar açar. Dosyaya başka bir karakter dizisi yazdıktan sonra, dosyanın tamamını okutup ekrana yazar ve dosyayı kapatır.