Share via


clearerr_s

restablece el indicador de error para una secuencia.Ésta es una versión de clearerr con mejoras de seguridad como se describe en Características de seguridad en CRT.

errno_t clearerr_s(
   FILE *stream 
);

Parámetros

  • stream
    puntero a la estructura de FILE

Valor devuelto

cero si correctamente; EINVAL si stream es NULL.

Comentarios

La función de clearerr_s restablece el indicador de error y la marca de fin de archivo para stream.los indicadores de error automáticamente no se borran; el indicador de error para una secuencia especificada se establece una vez, las operaciones en esa secuencia seguirán devolviendo un valor de error hasta clearerr_s, clearerr, fseek, fsetpos, o se llama rewind .

Si stream es NULL, se invoca el controlador no válido de parámetro, tal y como se describe en Validación de parámetros.Si la ejecución puede continuar, conjuntos errno de esta función a EINVAL y devuelven EINVAL.

Requisitos

rutina

Encabezado necesario

clearerr_s

<stdio.h>

Para obtener información adicional de compatibilidad, vea compatibilidad en la Introducción.

Ejemplo

// 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();
      }
   }
}
  error
 de nnWrite: Archivo dañado descriptor de archivo
¿La entrada provocará un error? n

Equivalente en .NET Framework

No es aplicable Para llamar a la función estándar de C, utilice PInvoke. Para obtener más información, vea La invocación de plataforma ejemplos.

Vea también

Referencia

Control de errores (CRT)

E/S de la secuencia

clearerr

_eof

feof

ferror

perror, _wperror