rewind

Перемещает указатель файла к началу файла.

void rewind(
   FILE *stream 
);

Параметры

  • stream
    Указатель на ФАЙЛ структура.

Заметки

rewind функция перемещает указатель файла, связанный с stream в начало файла.Вызов rewind подобно

(пустое) (fseek stream**"** 0L, SEEK_SET );

Однако непохоже fseek" rewind очищает индикаторы ошибки для потока, а также признак конца файла.Кроме того, непохоже fseek" rewind возвращает значение, указывающее, находится ли указатель был перемещен успешно.

Чтобы очистить буфер ввода, используйте rewind с потоком stdinпо умолчанию, которое связано с клавиатуры.

Если поток a NULL недопустимый указатель, вызывается обработчик параметра, как описано в разделе Проверка параметров.Если выполнение может быть продолжено, то эта функция возвращает и errno равно EINVAL.

Дополнительные сведения об этих и других кодах ошибок см. в разделе _doserrno, errno, _sys_errlist и _sys_nerr.

Требования

Процедура

Обязательный заголовок

rewind

<stdio.h>

Дополнительные сведения о совместимости см. Совместимость во введении.

Библиотеки

Все версии Библиотеки времени выполнения C.

Пример

// 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

Эквивалент в .NET Framework

Неприменимо. Для c# используйте стандартная функция PInvoke. Дополнительные сведения см. в разделе Примеры вызовов неуправляемого кода.

См. также

Ссылки

Поток ВВОДА-ВЫВОДА