Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

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

oldname

Puntero al nombre anterior.

newname

Puntero al nuevo nombre.

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.

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

rutina de TCHAR.H

_UNICODE y _MBCS no definido

_MBCS definido

_UNICODE definido

_trename

Cambiar nombre

Cambiar nombre

_wrename

rutina

Encabezado necesario

Cambiar nombre

<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

// 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'

Adiciones de comunidad

AGREGAR
Mostrar: