Se recomienda usar Visual Studio 2017

rename, _wrename

 

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

Cambiar el nombre de un archivo o directorio.

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

Parámetros

oldname
Puntero al nombre anterior.

NewName
Puntero al nombre nuevo.

Cada una de estas funciones devuelve 0 si es correcto. Produce un error, la función devuelve un valor distinto de cero y establece errno a uno de los siguientes valores:

EACCES
Archivo o directorio especificado por newname ya existe o no se pudo crear (ruta de acceso no válida); o oldname es un directorio y newname especifica una ruta de acceso diferente.

ENOENT
Archivo o ruta de acceso especificada por oldname no encontrado.

EINVAL
El nombre contiene caracteres no válidos.

Para otros posibles valores devueltos, consulte _doserrno, _errno, syserrlist y _sys_nerr.

El cambiar el nombre de función cambia el nombre del archivo o directorio especificado por oldname en el nombre proporcionado por newname. El nombre anterior debe ser la ruta de acceso de un archivo o directorio existente. El nuevo nombre no debe ser el nombre de un archivo o directorio existente. Puede usar cambiar el nombre de para mover un archivo de un directorio o dispositivo a otro, proporcionando una ruta de acceso diferente en el newname argumento. Sin embargo, no puede usar cambiar el nombre de para mover un directorio. Directorios pueden cambiar el nombre, pero no se mueven.

_wrenamees una versión con caracteres anchos de _rename; los argumentos de _wrename son cadenas de caracteres anchos. _wrenamey _rename se comportan exactamente igual.

Asignaciones de rutina de texto genérico

Rutina TCHAR.H_UNICODE y _MBCS no definidos_MBCS definido_UNICODE definido
_trenamecambiar el nombrecambiar el nombre_wrename
RutinaEncabezado necesario
cambiar el nombre<io.h>o<stdio.h></stdio.h></io.h>
_wrename<stdio.h> o <wchar.h>

Para obtener información adicional de compatibilidad, vea Compatibilidad en la Introducción.

Todas las versiones de las bibliotecas en tiempo de ejecución de 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

Control de archivos

Mostrar: