rename, _wrename
파일 또는 디렉터리의 이름을 바꿉니다.
int rename(
const char *oldname,
const char *newname
);
int _wrename(
const wchar_t *oldname,
const wchar_t *newname
);
매개 변수
기존 이름
이전 이름에 대 한 포인터입니다.새 이름
새 이름에 대 한 포인터입니다.
반환 값
각이 함수 성공 하면 0을 반환 합니다.오류, 0이 아닌 값 반환 하 고 설정 하는 errno 는 다음 값 중 하나:
EACCES
파일이 나 디렉터리에서 새 이름 이미 존재 하거나 (잘못 된 경로)를 만들 수 없습니다. 또는 기존 이름 디렉터리 및 새 이름 다른 경로 지정 합니다.ENOENT
지정 된 경로나 파일 기존 이름 찾을 수 없습니다.EINVAL
이름에 잘못 된 문자가 포함 되어 있습니다.
다른 가능한 반환 값을 참조 하십시오. _doserrno, _errno, syserrlist, 및 _sys_nerr.
설명
이름 바꾸기 함수는 파일이 나 디렉터리에서 지정 된 이름을 변경 기존 이름 에 의해 지정 된 이름이 새 이름.이전 이름이 기존 파일이 나 디렉터리의 경로 여야 합니다.기존 파일 또는 디렉터리의 이름을 새 이름이 아니어야 합니다.사용할 수 있습니다 이름 바꾸기 파일 디렉터리 또는 장치에서 다른 다른 경로 지정 이동 하는 새 이름 인수.그러나 사용할 수 없는 이름 바꾸기 디렉터리를 이동 합니다.디렉터리 이름을 바꾸거나, 수 있지만 이동할 수 있습니다.
_wrename와이드 문자 버전입니다 _rename. 한 인수 _wrename 와이드 문자 문자열입니다._wrename및 _rename 그렇지을 동일 하 게 작동 합니다.
일반 텍스트 루틴 매핑
TCHAR입니다.H 루틴 |
_UNICODE 및 _Mbcs가 정의 되지 않았습니다. |
_Mbcs가 정의 |
_Unicode가 정의 |
|---|---|---|---|
_trename |
이름 바꾸기 |
이름 바꾸기 |
_wrename |
요구 사항
루틴 |
필수 헤더 |
|---|---|
이름 바꾸기 |
<io.h> 또는 <stdio.h> |
_wrename |
<stdio.h> 또는 <wchar.h> |
추가 호환성 정보를 참조 하십시오. 호환성 소개에서 합니다.
라이브러리
모든 버전의 C 런타임 라이브러리.
예제
// 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'