clearerr_s

Artigo
06/09/2015

Redefine o indicador de erro de um fluxo. Essa é uma versão de clearerr com aprimoramentos de segurança conforme descrito em Recursos de segurança no CRT.

errno_t clearerr_s(
   FILE *stream 
);

Parâmetros

stream
Ponteiro para a estrutura de FILE

Valor de retorno

Zero se bem-sucedido; EINVALstream se for NULL.

Comentários

A função de clearerr_s redefine o indicador de erro e o indicador de participante de Arquivo para stream. Os indicadores de erro não estejam desmarcados automaticamente; o indicador de erro para um fluxo especificado é definido uma vez, as operações naquele fluxo continuam retornar um valor de erro até clearerr_s, clearerr, fseek, fsetpos, ou rewind é chamado.

Se stream for NULO, o manipulador de parâmetro inválido será invocado, conforme descrito em Validação do parâmetro. Se a execução puder continuar, essa função definirá errno como EINVAL e retornará EINVAL.

Requisitos

Rotina	Cabeçalho necessário
clearerr_s	<stdio.h>

Para informações adicionais de compatibilidade, consulte Compatibilidade na Introdução.

Exemplo

// crt_clearerr_s.c
// This program creates an error
// on the standard input stream, then clears
// it so that future reads won't fail.
 

#include <stdio.h>

int main( void )
{
   int c;
   errno_t err;

   // Create an error by writing to standard input.
   putc( 'c', stdin );
   if( ferror( stdin ) )
   {
      perror( "Write error" );
      err = clearerr_s( stdin );
      if (err != 0)
      {
         abort();
      }
   }

   // See if read causes an error.
   printf( "Will input cause an error? " );
   c = getc( stdin );
   if( ferror( stdin ) )
   {
      perror( "Read error" );
      err = clearerr_s( stdin );
      if (err != 0)
      {
         abort();
      }
   }
}