rename, _wrename

renommez un fichier ou un 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.

Valeur de retour

Chacune de ces fonctions retourne 0 s'il est réussi.Sur une erreur, la fonction retourne une valeur différente de zéro et définit errno l'une des valeurs suivantes :

• EACCES
  Le fichier ou le répertoire spécifié par le newname existe déjà ou ne peut pas être créé (chemin d'accès valide) ; ou oldname est un répertoire et le newname spécifie un chemin d'accès différent.

• ENOENT
  Fichier ou un chemin d'accès spécifié par oldname introuvable.

• EINVAL
  le nom contient des caractères non valides.

Pour d'autres valeurs de retour possibles, consultez _doserrno, _errno, syserrlist, et _sys_nerr.

Notes

La fonction de changement de nom renomme le fichier ou le répertoire spécifié par oldname au nom fourni par le newname.L'ancien nom doit être le chemin d'accès d'un fichier ou d'un répertoire.Le nouveau nom ne doit pas être le nom d'un fichier ou d'un répertoire.Vous pouvez utiliser changement de nom pour déplacer un fichier à partir d'un répertoire ou le périphérique à l'autre en affectant un chemin d'accès différent dans l'argument de newname .Toutefois, vous ne pouvez pas utiliser changement de nom pour déplacer un répertoire.Les répertoires peuvent être renommés, mais ne sont pas déplacés.

_wrename est une version à caractère élargi de _rename; les arguments à _wrename sont des chaînes à caractères larges._wrename et _rename se comportent de sinon.

mappages de routines de texte générique

Configuration requise

Pour des informations de compatibilité supplémentaires, consultez compatibilité dans l'introduction.

bibliothèques

toutes les versions de 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'

Équivalent .NET Framework

System : : E/S : : fichier : : Déplacement

Voir aussi

Référence

Gestion de fichiers