retroceder
Reposiciona o ponteiro de arquivo para o início de um arquivo.
void rewind(
FILE *stream
);
Parâmetros
- stream
Ponteiro para ARQUIVO estrutura.
Comentários
The retroceder função reposiciona o ponteiro de arquivo associado ao stream para o início do arquivo. Uma telefonar para retroceder é semelhante a
(void) fseek( stream**,** 0L, SEEK_SET );
No entanto, diferentemente fseek, retroceder limpa sistema autônomo indicadores de erro para o fluxo bem sistema autônomo o indicador de participante de arquivo.Além disso, ao contrário de fseek, retroceder não retorna um valor para indicar se o ponteiro foi movido com êxito.
Para desmarcar 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 ponteiro, o manipulador de parâmetro inválido é chamado, conforme descrito em Validação de parâmetro. Se a execução terá permissão para continuar, esta função retorna e errno é 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 compatibilidade, consulte Compatibilidade na introdução.
Bibliotecas
Todas as versões do C em time de execução bibliotecas.
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
Equivalente do NET Framework
Não aplicável. Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.