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
Rotina TCHAR.H |
_UNICODE & _MBCS não definido |
_MBCS definido |
_UNICODE definido |
|---|---|---|---|
_trename |
Renomear |
Renomear |
_wrename |
Requisitos
Rotina |
Cabeçalho necessário |
|---|---|
Renomear |
<io.h> ou <stdio.h> |
_wrename |
<stdio.h> ou <wchar.h> |
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'