База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

rename — преименуване на файл

Функцията rename от <stdio.h> променя името на файл. При успех връща 0, а при грешка — ненулева стойност.

Версия: C23; repository compiler flag, production runtime not attested

Синтаксис

#include <stdio.h>
int rename(const char *old, const char *new);

rename(old, new) приема два низа, завършващи с нулев знак: текущото име на файла и новото име. След успешното изпълнение файлът вече не е достъпен под старото си име.

Ако целевият файл вече съществува, поведението се определя от реализацията: не приемайте, че замяната ще е преносима. При грешка съществуващият изходен файл запазва първоначалното си име.

Операцията може да се провали например ако файлът е отворен или ако преименуването изисква копиране на съдържанието му. Примерът затваря файла преди преименуването и проверява резултата с != 0, а не с == -1.

Примери

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

int main(void)
{
    /* Run in a private directory where no other process changes these names. */
    FILE *file = fopen("rename-before.txt", "wx");
    if (file == NULL) {
        return EXIT_FAILURE;
    }
    if (fclose(file) != 0) {
        return EXIT_FAILURE;
    }

    /* Reserve the destination without opening or truncating an existing file. */
    FILE *destination = fopen("rename-after.txt", "wx");
    if (destination == NULL) {
        return EXIT_FAILURE;
    }
    if (fclose(destination) != 0) {
        remove("rename-after.txt");
        return EXIT_FAILURE;
    }

    /* Some implementations do not allow rename to replace the placeholder. */
    if (rename("rename-before.txt", "rename-after.txt") != 0) {
        remove("rename-after.txt");
        return EXIT_FAILURE;
    }
    if (remove("rename-after.txt") != 0) {
        return EXIT_FAILURE;
    }

    puts("Renamed and removed.");
    return EXIT_SUCCESS;
}

Резултат

Renamed and removed.

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници