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
routine de TCHAR.H |
_MBCS & de _UNICODE non défini |
_MBCS défini |
_UNICODE défini |
---|---|---|---|
_trename |
renommez |
renommez |
_wrename |
Configuration requise
routine |
en-tête requis |
---|---|
renommez |
<io.h> ou <stdio.h> |
_wrename |
<stdio.h> ou <wchar.h> |
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