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

Anforderungen

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

Siehe auch

Referenz

Datei-Behandlung