rename, _wrename
Přejmenování souboru nebo adresáře.
int rename(
const char *oldname,
const char *newname
);
int _wrename(
const wchar_t *oldname,
const wchar_t *newname
);
Parametry
oldname
Ukazatel na původní název.nový_název
Ukazatel na nový název.
Vrácená hodnota
Každá z těchto funkcí vrátí 0, pokud je úspěšná.Na chybu, vrátí nenulovou hodnotu a nastaví errno na jednu z následujících hodnot:
EACCES
Soubor nebo adresář zadaný v newname již existuje, nebo nelze vytvořit (neplatná cesta); nebo oldname je adresář a newname Určuje jinou cestu.ENOENT
Soubor nebo cesta, kterou určil oldname nebyl nalezen.EINVAL
Název obsahuje neplatné znaky.
Možné vrácené hodnoty, viz _doserrno, _errno, syserrlist a _sys_nerr.
Poznámky
Přejmenovat funkce přejmenuje soubor nebo adresář zadaný v oldname dán název newname.Starý název musí být cesta existující soubor nebo adresář.Nový název nesmí být název existující soubor nebo adresář.Můžete použít Přejmenovat přesunete soubor z jednoho adresáře nebo zařízení do jiného tím, že jinou cestu newname argument.Nelze však použít Přejmenovat přesunout adresář.Adresáře můžete přejmenovat však přesunut.
_wrenameje verze celého znaku _rename; argumenty _wrename jsou celý znak řetězce._wrenamea _rename chovají jinak shodně.
Obecný Text rutinní mapování
TCHAR.Rutina H |
_UNICODE & _MBCS není definován |
_MBCS, definice |
_UNICODE, definice |
|---|---|---|---|
_trename |
Přejmenovat |
Přejmenovat |
_wrename |
Požadavky
Rutina |
Požadované záhlaví |
|---|---|
Přejmenovat |
<io.h> nebo <stdio.h> |
_wrename |
<stdio.h> nebo <wchar.h> |
Další informace o kompatibilitě, viz Compatibility v úvodu.
Knihovny
Všechny verze C Runtime knihovny.
Příklad
// 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 );
}
Výsledek
File 'CRT_RENAMER.OBJ' renamed to 'CRT_RENAMER.JBO'