rewindrewind

파일 포인터의 위치를 파일의 시작 부분으로 변경합니다.Repositions the file pointer to the beginning of a file.

구문Syntax

void rewind(
   FILE *stream
);

매개 변수Parameters

스트림stream
FILE 구조체에 대한 포인터입니다.Pointer to FILE structure.

설명Remarks

되감기 함수는 스트림과 연결 된 파일 포인터의 위치를 파일의 시작 부분으로 다시 바꿉니다.The rewind function repositions the file pointer associated with stream to the beginning of the file. rewind에 대한 호출은 다음과 유사합니다.A call to rewind is similar to

(void) fseek ( stream, 0l, SEEK_SET);(void) fseek( stream, 0L, SEEK_SET );

그러나 fseek와는 달리 되감기 는 파일의 끝 표시기 뿐만 아니라 스트림의 오류 표시기를 지웁니다.However, unlike fseek, rewind clears the error indicators for the stream as well as the end-of-file indicator. 또한 fseek와 달리 되감기 는 포인터가 성공적으로 이동 했는지 여부를 나타내는 값을 반환 하지 않습니다.Also, unlike fseek, rewind does not return a value to indicate whether the pointer was successfully moved.

키보드 버퍼를 지우려면 기본적으로 키보드와 연결 되는 stream stdin과 함께 되감기 를 사용 합니다.To clear the keyboard buffer, use rewind with the stream stdin, which is associated with the keyboard by default.

Stream이 NULL 포인터인 경우 매개 변수 유효성 검사에 설명 된 대로 잘못 된 매개 변수 처리기가 호출 됩니다.If stream is a NULL pointer, the invalid parameter handler is invoked, as described in Parameter Validation. 계속 해 서 실행 하도록 허용한 경우이 함수는를 반환 하 고 errnoEINVAL로 설정 됩니다.If execution is allowed to continue, this function returns and errno is set to EINVAL.

이러한 오류 코드 및 기타 오류 코드에 대한 내용은 _doserrno, errno, _sys_errlist, and _sys_nerr을 참조하세요.For information on these and other error codes, see _doserrno, errno, _sys_errlist, and _sys_nerr.

기본적으로이 함수의 전역 상태는 응용 프로그램으로 범위가 지정 됩니다.By default, this function's global state is scoped to the application. 이를 변경 하려면 CRT의 전역 상태를 참조 하세요.To change this, see Global state in the CRT.

요구 사항Requirements

루틴에서 반환된 값Routine 필수 헤더Required header
되감습니다rewind <stdio.h><stdio.h>

호환성에 대한 자세한 내용은 Compatibility을 참조하세요.For additional compatibility information, see Compatibility.

라이브러리Libraries

모든 버전의 C 런타임 라이브러리입니다.All versions of the C run-time libraries.

예제Example

// crt_rewind.c
/* This program first opens a file named
* crt_rewind.out for input and output and writes two
* integers to the file. Next, it uses rewind to
* reposition the file pointer to the beginning of
* the file and reads the data back in.
*/
#include <stdio.h>

int main( void )
{
   FILE *stream;
   int data1, data2;

   data1 = 1;
   data2 = -37;

   fopen_s( &stream, "crt_rewind.out", "w+" );
   if( stream != NULL )
   {
      fprintf( stream, "%d %d", data1, data2 );
      printf( "The values written are: %d and %d\n", data1, data2 );
      rewind( stream );
      fscanf_s( stream, "%d %d", &data1, &data2 );
      printf( "The values read are: %d and %d\n", data1, data2 );
      fclose( stream );
   }
}

출력Output

The values written are: 1 and -37
The values read are: 1 and -37

참조See also

스트림 I/OStream I/O