rename, _wrename
Nennen Sie eine Datei oder ein Verzeichnis um.
int rename(
const char *oldname,
const char *newname
);
int _wrename(
const wchar_t *oldname,
const wchar_t *newname
);
Parameter
oldname
Zeiger dem alten Namen.Neuer Name
Zeiger zum neuen Namen.
Rückgabewert
Jede dieser Funktionen gibt 0 zurück, wenn es erfolgreich ist. 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 Verzeichnis, die von newname bereits angegeben werden, besteht oder konnte nicht erstellt (Ungültige Pfad); oder oldname ist ein Verzeichnis und newname gibt einem anderen Pfad.ENOENT
Datei oder Pfad durch das oldname nicht gefunden.EINVAL
Name enthält unzulässige Zeichen.
Für weitere mögliche Rückgabewerte finden Sie unter _doserrno, _errno, syserrlist und _sys_nerr.
Hinweise
Die umbenennen-Funktion wird die Datei oder das Verzeichnis, um die von oldname den Namen angegeben ist, der von newname angegeben wird. Der alte Name muss der Pfad einer vorhandenen Datei oder des Verzeichnisses befinden. Der neue Name darf keinen Namen einer vorhandenen Datei oder des Verzeichnisses befinden. Sie können umbenennen verwenden, um eine Datei aus einem Verzeichnis oder Geräten auf eine andere verschieben, indem Sie einen anderen Pfad im newname-Argument geben. Sie können umbenennen nicht verwenden, um ein Verzeichnis zu verschieben. Verzeichnisse können umbenannt, jedoch nicht verschoben werden.
_wrename ist eine Breitzeichen-Version von _rename; die Argumente für _wrename sind Zeichenfolgen mit Breitzeichen. _wrename und _rename identisch verhalten sich andernfalls.
Zuordnung generischer Textroutinen
TCHAR.H-Routine |
_UNICODE & _MBCS nicht definiert |
_MBCS definiert |
_UNICODE definiert |
|---|---|---|---|
_trename |
umbenennen |
umbenennen |
_wrename |
Anforderungen
Routine |
Erforderlicher Header |
|---|---|
umbenennen |
<io.h oder> stdio.h <> |
_wrename |
<stdio.h> oder <wchar.h> |
Zusätzliche Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.
Bibliotheken
Alle Versionen C-Laufzeitbibliotheken.
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 );
}
Ausgabe
File 'CRT_RENAMER.OBJ' renamed to 'CRT_RENAMER.JBO'