Função da biblioteca C - renomear ()

Descrição

A função da biblioteca C int rename(const char *old_filename, const char *new_filename) faz com que o nome do arquivo referido por old_filename para ser alterado para new_filename.

Declaração

A seguir está a declaração da função rename ().

int rename(const char *old_filename, const char *new_filename)

Parâmetros

  • old_filename - Esta é a string C que contém o nome do arquivo a ser renomeado e / ou movido.

  • new_filename - Esta é a string C que contém o novo nome do arquivo.

Valor de retorno

Em caso de sucesso, zero é retornado. Em caso de erro, -1 é retornado e errno é definido apropriadamente.

Exemplo

O exemplo a seguir mostra o uso da função rename ().

#include <stdio.h>

int main () {
   int ret;
   char oldname[] = "file.txt";
   char newname[] = "newfile.txt";
   
   ret = rename(oldname, newname);
	
   if(ret == 0) {
      printf("File renamed successfully");
   } else {
      printf("Error: unable to rename the file");
   }
   
   return(0);
}

Vamos supor que temos um arquivo de texto file.txt, tendo algum conteúdo. Então, vamos renomear este arquivo, usando o programa acima. Vamos compilar e executar o programa acima para produzir a seguinte mensagem e o arquivo será renomeado paranewfile.txt Arquivo.

File renamed successfully