rename, _wrename

 

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

Renommer un fichier ou répertoire.

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

Paramètres

OldName
Pointeur vers l’ancien nom.

NewName
Pointeur vers le nouveau nom.

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

EACCES
Fichier ou répertoire spécifié par newname existe déjà ou pas pu être créé (chemin d’accès non valide) ; ou oldname est un répertoire et newname spécifie un autre chemin d’accès.

ENOENT
Fichier ou chemin d’accès spécifié par oldname introuvable.

EINVAL
Le nom contient des caractères non valides.

Pour les autres valeurs de retour possibles, consultez la page _doserrno, _errno, syserrlist et _sys_nerr.

Le renommer 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’accès d’un fichier ou répertoire existant. Le nouveau nom ne peut pas le nom d’un fichier ou un répertoire existant. Vous pouvez utiliser renommer pour déplacer un fichier à partir d’un répertoire ou périphérique à un autre en donnant un autre chemin d’accès le newname argument. Toutefois, vous ne pouvez pas utiliser renommer pour déplacer un répertoire. Répertoires peuvent être renommés, mais pas déplacés.

_wrenameest une version à caractère élargi de _rename; les arguments de _wrename sont des chaînes à caractères larges. _wrenameet _rename se comportent de la même manière que dans le cas contraire.

Mappages de routines de texte générique

Routine TCHAR.H_UNICODE et _MBCS non définis_MBCS défini_UNICODE défini
_trenamechangement de nomchangement de nom_wrename
RoutineEn-tête requis
changement de nom<io.h>ou<stdio.h></stdio.h></io.h>
_wrename<stdio.h> ou <wchar.h>

Pour plus d'informations sur la compatibilité, voir Compatibilité dans l'introduction.

Toutes les versions des bibliothèques Runtime C.

// 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 );  
}  

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

System::IO::file::Move

Gestion de fichiers

Afficher: