Exporter (0) Imprimer
Développer tout
and
div
eof
not
or
xor
Développer Réduire
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

rename, _wrename

Renommer un fichier ou un répertoire.

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

oldname

Pointeur vers l'ancien nom.

newname

Pointeur vers le nouveau nom.

Chacune de ces fonctions retourne 0 en cas de succès. 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 newname existe déjà ou n'a pas pu être créé (chemin d'accès non valide) ; ou oldname est un répertoire et le newname spécifie un chemin différent.

ENOENT

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

EINVAL

Nom contient des caractères non valides.

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

La fonction renommer renomme le fichier ou le répertoire spécifié par oldname avec le nom fourni par newname. L'ancien nom doit correspondre au chemin d'accès d'un fichier existant ou d'un répertoire. Le nouveau nom ne doit pas être le nom d'un fichier existant ou d'un répertoire. Vous pouvez utiliser renommer pour déplacer un fichier à partir d'un répertoire ou d'un périphérique à l'autre en donnant un chemin différent dans l'argument de newname. Toutefois, vous ne pouvez pas utiliser renommer pour déplacer un répertoire. Les répertoires peuvent être renommés, mais pas être 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.

Mappages de routines de texte générique

Routine TCHAR.H

_UNICODE & _MBCS non définis

_MBCS défini

_UNICODE défini

_trename

renommer

renommer

_wrename

Routine

En-tête requis

renommer

<io.h> or <stdio.h>

_wrename

<stdio.h> ou <wchar.h>

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

Bibliothèques

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'

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft