rename
| Types and objects | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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) |
|
|
Documentation C++
pour
rename
|
|