yeniden adlandır, _wrename
Bir dosya veya dizin yeniden adlandırın.
int rename(
const char *oldname,
const char *newname
);
int _wrename(
const wchar_t *oldname,
const wchar_t *newname
);
Parametreler
OldName
Eski adı için işaretçi.Yeni ad
Yeni bir ad için işaretçi.
Dönüş Değeri
Başarılı olursa bu işlevlerden her biri 0 değerini döndürür.Sıfır dışında bir değere işlevi bir hata verir ve ayarlar errno aşağıdaki değerlerden biri:
EACCES
Dosya veya dizin ile belirtilen YeniAd zaten var veya (geçersiz yol) oluşturulamadı; veya oldname bir dizindir ve YeniAd farklı bir yol belirtir.ENOENT
Dosya veya yol ile belirtilen EskiAd bulunamadı.EINVAL
Adı geçersiz karakterler içeriyor.
Diğer olası dönüş değerleri için bkz: _doserrno, _errno, syserrlist ve _sys_nerr.
Notlar
Yeniden adlandırma işlevini yeniden adlandırır dosya veya dizin ile belirtilen oldname tarafından verilen ad için YeniAd.Eski adı varolan bir dosya veya dizin yolu olmalıdır.Yeni adı varolan bir dosya veya dizin adı olmamalıdır.Kullanabileceğiniz yeniden bir dosyanın bir dizin veya aygıt tarafından farklı bir yol vererek taşımak için YeniAd bağımsız değişkeni.Ancak kullanamazsınız yeniden bir dizini taşımak için.Dizinler yeniden adlandırıldı ancak taşınmadı.
_wrenamegeniş karakter sürümü _rename; bağımsız _wrename geniş karakter dizeleridir._wrenameve _rename Aksi takdirde aynı şekilde davranır.
Genel metin yordamı eşlemeleri
TCHAR.H yordamına girildi |
_UNICODE & _mbcs tanımlı değil |
Tanımlanan _mbcs |
Tanımlanan _UNICODE |
|---|---|---|---|
_trename |
Yeniden Adlandır |
Yeniden Adlandır |
_wrename |
Gereksinimler
Yordamı |
Gerekli başlık |
|---|---|
Yeniden Adlandır |
<io.h> veya <stdio.h> |
_wrename |
<stdio.h> veya <wchar.h> |
Ek uyumluluk bilgileri için bkz: Uyumluluk giriş.
Kitaplıkları
Tüm sürümleri c çalışma zamanı kitaplıkları.
Örnek
// 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 );
}
Çıktı
File 'CRT_RENAMER.OBJ' renamed to 'CRT_RENAMER.JBO'