rename, _wrename
Zmień nazwę pliku lub katalogu.
int rename(
const char *oldname,
const char *newname
);
int _wrename(
const wchar_t *oldname,
const wchar_t *newname
);
Parametry
StaraNazwa
Wskaźnik do starej nazwy.nowa_nazwa
Wskaźnik do nowej nazwy.
Wartość zwracana
Każda z tych funkcji zwraca wartość 0, jeśli powiedzie się.Na błąd, funkcja zwraca wartość różną od zera i ustawia errno do jednego z następujących wartości:
EACCES
Plik lub katalog określony przez NowaNazwa już istnieje lub nie można utworzyć (Nieprawidłowa ścieżka); lub StaraNazwa jest katalogu i NowaNazwa Określa inną ścieżkę.ENOENT
Plik lub ścieżka określona przez StaraNazwa nie można odnaleźć.EINVAL
Nazwa zawiera nieprawidłowe znaki.
Inne możliwe zwracane wartości, zobacz _doserrno, _errno, syserrlist i _sys_nerr.
Uwagi
Zmienić funkcja zmienia nazwę pliku lub katalogu określonego przez StaraNazwa do nazwa nadana przez NowaNazwa.Stara nazwa musi być ścieżka istniejącego pliku lub katalogu.Nowa nazwa nie może być nazwa istniejącego pliku lub katalogu.Można użyć zmienić , aby przenieść plik z jednego katalogu lub urządzenia, dając inną ścieżkę NowaNazwa argument.Nie można jednak używać zmienić Aby przenieść katalog.Katalogi można zmienić nazwy, ale nie przeniesiony.
_wrenamejest to wersja szerokich znaków _rename; argumenty do _wrename są ciągami szerokich znaków._wrenamei _rename zachowują się identycznie inaczej.
Tekst rodzajowy rutynowych mapowania
TCHAR.Rutynowe H |
_UNICODE & Nie zdefiniowano _MBCS |
_MBCS, definicja |
_UNICODE, definicja |
|---|---|---|---|
_trename |
Zmienianie nazwy |
Zmienianie nazwy |
_wrename |
Wymagania
Rozpoczęto wykonywanie procedury |
Wymaganego nagłówka |
|---|---|
Zmienianie nazwy |
<io.h> lub <stdio.h> |
_wrename |
<stdio.h> lub <wchar.h> |
Aby uzyskać dodatkowe informacje o zgodności, zobacz zgodności we wprowadzeniu.
Biblioteki
Wszystkie wersje biblioteki uruchomieniowej c.
Przykład
// 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 );
}
Dane wyjściowe
File 'CRT_RENAMER.OBJ' renamed to 'CRT_RENAMER.JBO'