Umbenennen, _wrename
Umbenennen einer Datei oder ein Verzeichnis.
int rename(
const char *oldname,
const char *newname
);
int _wrename(
const wchar_t *oldname,
const wchar_t *newname
);
Parameter
oldname
Zeiger auf den alten Namen.newname
Zeiger auf den neuen Namen angezeigt.
Rückgabewert
Jede dieser Funktionen gibt 0 zurück, wenn die Methode erfolgreich ausgeführt wurde.Auf einem Fehler gibt die Funktion einen Wert ungleich 0 (null) zurück und legt errno auf einen der folgenden Werte fest:
EACCES
Die Datei oder das Verzeichnis bereits durch newname angegeben werden, vorhanden oder konnte nicht erstellt wurden (Ungültiger Pfad); oldname ist oder ein Verzeichnis und newname gibt einen anderen Pfad an.ENOENT
Datei oder Pfad angegeben durch das oldname nicht gefunden.EINVAL
Name enthält ungültige Zeichen.
Eine weitere mögliche Rückgabewerte finden Sie unter _doserrno, _errno, syserrlist und _sys_nerr.
Hinweise
Die Funktion Umbenennen die Datei oder das Verzeichnis umbenennt, die von oldname dem Namen angegeben wird, der durch newnameangegeben ist.Der alte Name muss der Pfad einer vorhandenen Datei oder des Verzeichnisses befinden.Der neue Name darf nicht der Name einer vorhandenen Datei oder des Verzeichnisses befinden.Sie können Umbenennen können Sie eine Datei aus einem Verzeichnis oder ein anderes Gerät zu verschieben, indem Sie einen anderen Pfad im newname-Argument sein.Sie können jedoch Umbenennen nicht verwenden, um ein Verzeichnis verschoben werden soll.Verzeichnisse können umbenannt werden, aber nicht verschoben werden.
_wrename ist eine Breitzeichen-Version von _rename. _wrename sind die Argumente für Zeichenfolgen mit Breitzeichen._wrename und _rename verhalten sich ansonsten unterscheiden.
Zuweisung generischer Textroutinen
TCHAR.H-Routine |
_UNICODE & _MBCS nicht definiert |
_MBCS definieren |
_UNICODE definiert |
|---|---|---|---|
_trename |
Umbenennen |
Umbenennen |
_wrename |
Anforderungen
Routine |
Erforderlicher Header |
|---|---|
Umbenennen |
<io.h> oder <stdio.h> |
_wrename |
<stdio.h> oder <wchar.h> |
Um Kompatibilität zusätzlichen Informationen finden Sie unter Kompatibilität in der Einführung.
Bibliotheken
Alle Versionen Cs.
Beispiel
// 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'
.NET Framework-Entsprechung
System::EA::Datei::Verschieben