_futime, _futime32, _futime64

  • 아티클

열린 파일의 수정 시간을 설정합니다.

구문

int _futime(
   int fd,
   struct _utimbuf *filetime
);
int _futime32(
   int fd,
   struct __utimbuf32 *filetime
);
int _futime64(
   int fd,
   struct __utimbuf64 *filetime
);

매개 변수

fd
열린 파일에 대한 파일 설명자입니다.

filetime
새 수정 날짜를 포함하는 구조체에 대한 포인터입니다.

반환 값

성공하면 0을 반환합니다. 오류가 발생하면 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기가 호출됩니다. 실행을 계속할 수 있는 경우 함수는 -1을 반환하고 errno 잘못된 파일 설명자를 나타내거나 EINVAL잘못된 매개 변수를 나타내는 -1로 설정EBADF됩니다.

설명

루틴은 _futime 연결된 fd열린 파일의 수정 날짜 및 액세스 시간을 설정합니다. _futime 는 해당 인수가 파일 이름이나 파일 경로가 아니라 열린 파일의 파일 설명자라는 점을 제외하고 동일합니다 _utime. _utimbuf 구조체에는 새 수정 날짜 및 액세스 시간에 대한 필드가 포함됩니다. 두 필드 모두 유효한 값을 포함합니다. _utimbuf32 및 _utimbuf64는 각각 32비트 및 64비트 시간 형식을 사용한다는 점을 제외하고 _utimbuf와 동일합니다. _futime 및 _utimbuf는 64비트 시간 형식을 사용하고 _futime의 동작은 _futime64와 동일합니다. 이전 동작을 강제 적용하려면 _USE_32BIT_TIME_T를 정의합니다. 이렇게 하면 _futime의 동작이 _futime32와 동일하고 _utimbuf 구조체에서 32비트 시간 형식이 사용되어 __utimbuf32와 동일해집니다.

__utimbuf64 구조체를 사용하는 _futime64는 3000년 12월 31일 23:59:59(UTC)까지 파일 날짜를 일고 수정할 수 있습니다. 반면, 파일의 날짜가 2038년 1월 18일 23:59:59(UTC)보다 나중인 경우에는 _futime32 호출에 실패합니다. 1970년 1월 1일 자정은 이러한 함수에 대한 날짜 범위의 하한입니다.

기본적으로 이 함수의 전역 상태는 애플리케이션으로 범위가 지정됩니다. 이 동작을 변경하려면 CRT의 전역 상태를 참조하세요.

요구 사항

함수 필수 헤더 선택적 헤더
_futime <sys/utime.h> <errno.h>
_futime32 <sys/utime.h> <errno.h>
_futime64 <sys/utime.h> <errno.h>

호환성에 대한 자세한 내용은 호환성을 참조하세요.

예시

// crt_futime.c
// This program uses _futime to set the
// file-modification time to the current time.

#include <stdio.h>
#include <stdlib.h>
#include <fcntl.h>
#include <io.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <sys/utime.h>
#include <share.h>

int main( void )
{
   int hFile;

   // Show file time before and after.
   system( "dir crt_futime.c_input" );

   _sopen_s( &hFile, "crt_futime.c_input", _O_RDWR, _SH_DENYNO, 0 );

   if( _futime( hFile, NULL ) == -1 )
      perror( "_futime failed\n" );
   else
      printf( "File time modified\n" );

   _close (hFile);

   system( "dir crt_futime.c_input" );
}

입력: crt_futime.c_input

Arbitrary file contents.

샘플 출력

Volume in drive Z has no label.
Volume Serial Number is 5C68-57C1

Directory of Z:\crt

03/25/2004  10:40 AM                24 crt_futime.c_input
               1 File(s)             24 bytes
               0 Dir(s)  24,268,476,416 bytes free
Volume in drive Z has no label.
Volume Serial Number is 5C68-57C1

Directory of Z:\crt

03/25/2004  10:41 AM                24 crt_futime.c_input
               1 File(s)             24 bytes
               0 Dir(s)  24,268,476,416 bytes free
File time modified

참고 항목

시간 관리