Exportar (0) Imprimir
Expandir todo
and
div
eof
not
or
xor
Expandir Minimizar
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

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

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.

// 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:
© 2014 Microsoft