rename

[funkcja] Zmienia nazwę pliku.

Składnia

#include <cstdio>

int rename( const char * oldname, const char * newname );

Opis szczegółowy

Zmienia nazwę pliku z oldname na newname. Jeżeli oldname i newname wskazują na różne katalogi to plik zostanie przeniesiony.

Argumenty

nazwa argumentu	opis
oldname	Nazwa pliku wraz ze ścieżką, który ma zostać przeniesiony. Ścieżka może być w postaci relatywnej.
newname	Nowa nazwa pliku wraz ze ścieżką, określającą nowe miejsce i nazwę dla pliku. Ścieżka może być w postaci relatywnej.

Zwracana wartość

Funkcja zwróci wartość 0 jeżeli operacja została wykonana pomyślnie. W przeciwnym wypadku funkcja zwraca wartość różną od zera oraz ustawia odpowiedni numer błędu (patrz: _{» standard C ♦}errno).

Dodatkowe informacje

Pamiętaj, że argument newname nie może wskazywać na istniejący plik. Za pomocą tej funkcji możesz zmieniać nazwy katalogów i plików. Funkcja rename umożliwia również przenoszenie plików. Nie można jednak przy pomocy tej funkcji przenosić katalogów.

Przykład

#include <cstdio>

int main() {

if( rename( "oldname.txt", "newname.txt" ) == 0 )
printf( "zmiana nazwy powiodla sie" );
else
printf( "zmiana nazwy nie powiodla sie" );

return 0;
}

Standardowe wyjście programu:

zmiana nazwy nie powiodla sie

Zagadnienia powiązane

remove	Kasuje plik o podanej nazwie. (funkcja)

Linki zewnętrzne

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.

Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.