Renomear, _wrename

Renomear um arquivo ou diretório.

int rename(
   const char *oldname,
   const char *newname 
);
int _wrename(
   const wchar_t *oldname,
   const wchar_t *newname 
);

Parâmetros

• oldname faz
  Ponteiro para o nome antigo.

• newname
  Ponteiro para o novo nome.

Valor de retorno

Cada uma dessas funções retornará 0 se for bem-sucedida.Em um erro, a função retorna um valor diferente de zero e define errno um dos seguintes valores:

• EACCES
  Arquivo ou diretório especificado por newname já existe ou não pôde ser criado (caminho inválido;) ou oldname faz é um diretório e newname Especifica um caminho diferente.

• ENOENT
  Arquivo ou caminho especificado por oldname faz não encontrado.

• EINVAL
  Nome contém caracteres inválidos.

Para outros valores de retorno possíveis, consulte _doserrno, _errno, syserrlist e _sys_nerr.

Comentários

The Renomear função renomeia o arquivo ou diretório especificado por oldname faz para o nome dado por newname.O nome antigo deve ser o caminho de um arquivo existente ou diretório.O novo nome não deve ser o nome de um arquivo ou diretório existente.Você pode usar Renomear para mover um arquivo de um diretório ou dispositivo para outro, oferecendo um caminho diferente no newname argumento.No entanto, não é possível usar Renomear para mover um diretório.Diretórios podem ser renomeados, mas não movidos.

_wrename é uma versão de caractere largo da _rename; os argumentos para _wrename são seqüências de caracteres largos. _wrename e _renameEspecifique identicamente outro comportamento.

Mapeamentos de rotina de texto genérica

Requisitos

Para obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.

Bibliotecas

Todas as versões do C em time de execução bibliotecas.

Exemplo

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

Saída

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

Equivalente do NET Framework

sistema::IO::arquivo::Move

Consulte também

Referência

Manipulação de arquivos