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'