Namespaces
Variants

rename

From cppreference.net
< c ‎ | io
Défini dans l'en-tête <stdio.h>
int rename ( const char * old_filename, const char * new_filename ) ;

Modifie le nom de fichier d'un fichier. Le fichier est identifié par la chaîne de caractères pointée par old_filename . Le nouveau nom de fichier est identifié par la chaîne de caractères pointée par new_filename .

Si new_filename existe, le comportement est défini par l'implémentation.

Table des matières

Paramètres

old_filename - pointeur vers une chaîne de caractères terminée par un caractère nul contenant le chemin identifiant le fichier à renommer
new_filename - pointeur vers une chaîne de caractères terminée par un caractère nul contenant le nouveau chemin du fichier

Valeur de retour

0 en cas de succès ou une valeur non nulle en cas d'erreur.

Notes

POSIX spécifie de nombreux détails supplémentaires sur la sémantique de cette fonction.

Exemple

#include <stdio.h>
#include <stdlib.h>
int main(void)
{
    FILE* fp = fopen("from.txt", "w"); // créer le fichier "from.txt"
    if (!fp)
    {
        perror("from.txt");
        return EXIT_FAILURE;
    }
    fputc('a', fp); // écrire dans "from.txt"
    fclose(fp);
    int rc = rename("from.txt", "to.txt");
    if (rc)
    {
        perror("rename");
        return EXIT_FAILURE;
    }
    fp = fopen("to.txt", "r");
    if(!fp)
    {
        perror("to.txt");
        return EXIT_FAILURE;
    }
    printf("%c\n", fgetc(fp)); // lire depuis "to.txt"
    fclose(fp);
    return EXIT_SUCCESS;
}

Sortie possible :

a

Références

  • Norme C23 (ISO/IEC 9899:2024):
  • 7.21.4.2 La fonction rename (p: TBD)
  • Norme C17 (ISO/CEI 9899:2018) :
  • 7.21.4.2 La fonction rename (p: TBD)
  • Norme C11 (ISO/CEI 9899:2011) :
  • 7.21.4.2 La fonction rename (p: 302-303)
  • Norme C99 (ISO/CEI 9899:1999) :
  • 7.19.4.2 La fonction rename (p: 268-269)
  • Norme C89/C90 (ISO/IEC 9899:1990) :
  • 4.9.4.2 La fonction rename

Voir aussi

efface un fichier
(fonction)