ferrorferror

Vérifie si une erreur affecte un flux.Tests for an error on a stream.

SyntaxeSyntax

int ferror(
   FILE *stream
);

ParamètresParameters

streamstream
Pointeur désignant la structure FILE.Pointer to FILE structure.

Valeur de retourReturn Value

Si aucune erreur ne s’est produite sur le flux , le cotablit retourne 0.If no error has occurred on stream, ferror returns 0. Dans le cas contraire, une valeur différente de zéro est retournée.Otherwise, it returns a nonzero value. Si Stream a la valeur null, il appelle le gestionnaire de paramètre non valide, comme décrit dans validation de paramètre.If stream is NULL, ferror invokes the invalid parameter handler, as described in Parameter Validation. Si l’exécution est autorisée à se poursuivre, cette fonction affecte à errno la valeur EINVAL et retourne 0.If execution is allowed to continue, this function sets errno to EINVAL and returns 0.

Pour plus d’informations sur ces codes d’erreur et les autres, consultez _doserrno, errno, _sys_errlist et _sys_nerr.See _doserrno, errno, _sys_errlist, and _sys_nerr for more information on these, and other, error codes.

NotesRemarks

La routine de la réferrouse (implémentée en tant que fonction et en tant que macro) teste une erreur de lecture ou d’écriture sur le fichier associé au flux.The ferror routine (implemented both as a function and as a macro) tests for a reading or writing error on the file associated with stream. Si une erreur s’est produite, l’indicateur d’erreur pour le flux reste défini jusqu’à ce que le flux soit fermé ou rembobiné, ou jusqu’à ce que clearerr soit appelé.If an error has occurred, the error indicator for the stream remains set until the stream is closed or rewound, or until clearerr is called against it.

Configuration requiseRequirements

FonctionFunction En-tête requisRequired header
ferrorferror <stdio.h><stdio.h>

Pour plus d’informations sur la compatibilité, voir consultez Compatibilité.For additional compatibility information, see Compatibility.

ExemplesExample

Consultez l’exemple relatif à feof.See the example for feof.

Voir aussiSee also

Gestion des erreursError Handling
E/S de fluxStream I/O
clearerrclearerr
_eof_eof
feoffeof
fopen, _wfopenfopen, _wfopen
perror, _wperrorperror, _wperror