rename, _wrename

Suppriment un fichier ou un répertoire.

Syntaxe

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

Paramètres

oldname
Pointeur désignant l’ancien nom.

newname
Pointeur désignant le nouveau nom.

Valeur retournée

Chacune de ces fonctions retourne 0 si elle réussit. En cas d’erreur, la fonction retourne une valeur différente de zéro et affecte à errno l’une des valeurs suivantes :

Valeur errno	Condition
EACCES	Le fichier ou le répertoire spécifié par newname existe déjà ou n’a pas pu être créé (chemin d’accès non valide) ; ou oldname il s’agit d’un répertoire et newname spécifie un chemin différent.
ENOENT	Fichier ou chemin spécifié par oldname introuvable.
EINVAL	Le nom contient des caractères non valides.

Pour obtenir d’autres valeurs de retour possibles, consultez , , syserrlist_errno, et_sys_nerr ._doserrno

Notes

La rename fonction renomme le fichier ou le répertoire spécifié par oldname le nom donné par newname. L’ancien nom doit être le chemin d’un fichier ou répertoire existant. Le nouveau nom doit être le nom d’un fichier ou répertoire existant. Vous pouvez utiliser rename pour déplacer un fichier d’un répertoire ou d’un appareil vers un autre en donnant un chemin différent dans l’argument newname . Toutefois, vous ne pouvez pas utiliser rename pour déplacer un répertoire. Les répertoires peuvent être renommés, mais pas déplacés.

_wrename est une version à caractères larges de _rename; les arguments de _wrename sont des chaînes à caractères larges. Sinon,_wrename et _rename se comportent de la même façon.

Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.

Mappages de routine de texte générique

TCHAR.H Routine	_UNICODE et _MBCS non défini	_MBCS Défini	_UNICODE Défini
_trename	rename	rename	_wrename

Spécifications

Routine	En-tête requis
rename	<io.h> ou <stdio.h>
_wrename	<stdio.h> ou <wchar.h>

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Bibliothèques

Toutes les versions des bibliothèques Runtime C.

Exemple

// crt_renamer.c
/* This program attempts to rename a file named
* CRT_RENAMER.OBJ to CRT_RENAMER.JBO. For this operation
* to succeed, a file named CRT_RENAMER.OBJ must exist and
* a file named CRT_RENAMER.JBO must not exist.
*/

#include <stdio.h>

int main( void )
{
   int  result;
   char old[] = "CRT_RENAMER.OBJ", new[] = "CRT_RENAMER.JBO";

   /* Attempt to rename file: */
   result = rename( old, new );
   if( result != 0 )
      printf( "Could not rename '%s'\n", old );
   else
      printf( "File '%s' renamed to '%s'\n", old, new );
}

Sortie

File 'CRT_RENAMER.OBJ' renamed to 'CRT_RENAMER.JBO'

Voir aussi

Gestion des fichiers