rename

(PHP 3, PHP 4, PHP 5)

rename -- Benennt eine Datei oder ein Verzeichnis um

Beschreibung

bool rename ( string oldname, string newname [, resource context] )

Versucht oldname in newname umzubenennen.

Gibt bei Erfolg TRUE zurück, im Fehlerfall FALSE.

Beispiel 1. Beispiel mit rename()

<?php
  rename
("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt");
?>

Anmerkung: In Versionen vor PHP 4.3.3 konnte rename() auf *nix-basierten Systemen nicht partitionsübergreifend verschieben.

Anmerkung: Ab PHP 5.0.0 kann rename() mit manchen Url-Wrappern benutzt werden. Siehe Anhang L für eine Liste von Wrappern die rename() unterstützen. Wenn Wrapper verwendet werden, muss für oldname und newname der gleiche Wrapper benutzt werden.

Anmerkung: Der context Parameter ist ab PHP 5.0.0 verfügbar.

Siehe auch copy(), unlink() und move_uploaded_file().

Hosting by: Hurra Communications GmbH
Generated: 2007-01-26 17:57:08