retroceder
Reposiciona o ponteiro do arquivo para o início de um arquivo.
void rewind(
FILE *stream
);
Parâmetros
- stream
Ponteiro para arquivo estrutura.
Comentários
O Retroceder função reposiciona o ponteiro de arquivo associado stream para o início do arquivo.Uma chamada para Retroceder é semelhante a
(void) fseek( stream**,** 0L, SEEK_SET );
No entanto, diferentemente fseek, Retroceder limpa os indicadores de erro para o fluxo, como também o indicador de fim-de-arquivo.Além disso, diferentemente de fseek, Retroceder não retorna um valor para indicar se o ponteiro foi movido com êxito.
Para limpar o buffer de teclado, use Retroceder com o fluxo de stdin, que está associado com o teclado, por padrão.
Se o fluxo é um NULL o ponteiro, o manipulador de parâmetro inválido é invocado, conforme descrito em Validação de parâmetro.Se a execução terá permissão para continuar, esta função retorna e errno for definido como EINVAL.
Para obter informações sobre estes e outros códigos de erro, consulte _doserrno, errno, _sys_errlist e _sys_nerr.
Requisitos
Rotina |
Cabeçalho necessário |
|---|---|
retroceder |
<stdio.h> |
Para obter informações adicionais de compatibilidade, consulte compatibilidade na introdução.
Bibliotecas
Todas as versões da bibliotecas de tempo de execução c.
Exemplo
// 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 );
}
}
Saída
The values written are: 1 and -37
The values read are: 1 and -37
Equivalência do .NET Framework
Não aplicável. Para chamar a função c padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.