Compartir a través de


rename, _wrename

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 nuevo nombre.

Valor devuelto

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

  • EACCES
    El archivo o el directorio especificado por newname existe o no puede estar ya creado (ruta no válida); o el oldname es un directorio y newname especifica una ruta de acceso diferente.

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

  • EINVAL
    El nombre contiene caracteres no válidos.

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

Comentarios

La función de rename cambia el nombre del archivo o el directorio especificado por el oldname al nombre especificado en newname. El nombre anterior debe ser la ruta de acceso de un archivo existente o un directorio. El nuevo nombre no debe ser el nombre de un archivo existente o un directorio. Puede utilizar rename para mover un archivo a partir de un directorio o el dispositivo a otro dando una ruta de acceso diferente en el argumento de newname . Sin embargo, no puede utilizar rename para mover un directorio. Los directorios se puede cambiar, pero no mover.

_wrename es una versión con caracteres anchos de _rename; los argumentos de _wrename son cadenas de caracteres. _wrename y _rename se comportan exactamente igual de otra manera.

Asignaciones de rutina de texto genérico

Rutina TCHAR.H

_UNICODE y _MBCS no definidos

_MBCS definido

_UNICODE definido

_trename

cambie

cambie

_wrename

Requisitos

Rutina

Encabezado necesario

cambie

<io.h o> stdio.h <>

_wrename

<stdio.h> o <wchar.h>

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

Bibliotecas

Todas las versiones de las bibliotecas en tiempo de ejecución de C.

Ejemplo

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

Resultados

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

Equivalente en .NET Framework

System::IO::File::Move

Vea también

Referencia

Control de archivos