Compartilhar via


clearerr_s

Redefine o indicador de erros para um fluxo.Esta é uma versão de clearerr com aprimoramentos de segurança conforme descrito em Aprimoramentos de segurança no CRT.

errno_t clearerr_s(
   FILE *stream 
);

Parâmetros

  • stream
    Ponteiro para FILE estrutura

Valor de retorno

Zero se for bem-sucedido; EINVAL Se stream é nulo.

Comentários

The clearerr_s função redefine o indicador de erro e o indicador de participante de arquivo para stream. Indicadores de erro não são limpas automaticamente; assim que o indicador de erros para um fluxo especificado estiver definido, operações em desse fluxo continuam retornar um valor de erro até clearerr_s, clearerr, fseek, fsetpos, ou rewind é chamado.

If stream for nulo, o manipulador de parâmetro inválido é invocado, sistema autônomo descrito em Validação de parâmetro. Se a execução for permitida para continuar, essa função define errno para EINVAL e retornos EINVAL.

Requisitos

Rotina

Cabeçalho necessário

clearerr_s

<stdio.h>

Para obter informações adicionais 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();
      }
   }
}
n
Write error: Bad file descriptor Will input cause an error? n

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.

Consulte também

Referência

Erro Handling (CRT)

Fluxo de E/S

clearerr

_eof

feof

ferror

perror, _wperror