rename, _wrename

Mengganti nama file atau direktori.

Sintaks

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

Parameter

oldname
Penunjuk ke nama lama.

newname
Penunjuk ke nama baru.

Nilai hasil

Masing-masing fungsi ini mengembalikan 0 jika berhasil. Pada kesalahan, fungsi mengembalikan nilai bukan nol dan diatur errno ke salah satu nilai berikut:

errno nilai	Kondisi
EACCES	File atau direktori yang ditentukan oleh newname sudah ada atau tidak dapat dibuat (jalur tidak valid); atau oldname merupakan direktori dan newname menentukan jalur yang berbeda.
ENOENT	File atau jalur yang ditentukan oleh oldname tidak ditemukan.
EINVAL	Nama berisi karakter yang tidak valid.

Untuk kemungkinan nilai pengembalian lainnya, lihat _doserrno, , syserrlist_errno, dan _sys_nerr.

Keterangan

Fungsi mengganti rename nama file atau direktori yang ditentukan oleh oldname menjadi nama yang diberikan oleh newname. Nama lama harus berupa jalur file atau direktori yang ada. Nama baru tidak boleh menjadi nama file atau direktori yang ada. Anda dapat menggunakan rename untuk memindahkan file dari satu direktori atau perangkat ke direktori lain dengan memberikan jalur yang berbeda dalam newname argumen. Namun, Anda tidak dapat menggunakan rename untuk memindahkan direktori. Direktori dapat diganti namanya, tetapi tidak dipindahkan.

_wrename adalah versi karakter luas dari _rename; argumen untuk _wrename adalah string karakter lebar. _wrename dan _rename berulah secara identik jika tidak.

Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.

Pemetaan rutin teks generik

TCHAR.H Rutin	_UNICODE dan _MBCS tidak ditentukan	_MBCS Didefinisikan	_UNICODE Didefinisikan
_trename	rename	rename	_wrename

Persyaratan

Rutin	Header yang diperlukan
rename	<io.h> atau <stdio.h>
_wrename	<stdio.h> atau <wchar.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Pustaka

Semua versi pustaka run-time C.

Contoh

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

Output

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

Lihat juga

Penanganan file