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 Cambiar nombre 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 Cambiar nombre 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 Cambiar nombre 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 la rutina de texto genérico

Requisitos

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

bibliotecas

todas las versiones de 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 );
}

Output

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

Equivalente en .NET Framework

System:: IO:: archivo:: Mover

Vea también

Referencia

El control de archivo