NAME

       gd_error_count — report the number of errors encountered by the GetData library

SYNOPSIS

       #inlcude <getdata.h>

       int gd_error_count(DIRFILE *dirfile);

DESCRIPTION

       The  first time gd_error_count() is called with the DIRFILE object dirfile, it returns the
       number of errors encountered by the GetData library while operating on dirfile  since  its
       creation.   Calling  this  function resets the internal count, so that subsequent calls to
       gd_error_count() return the number of errors encountered only since the previous  call  to
       this function, for the specified DIRFILE.

       The errors themselves are not cached by the library.  The error status of the last library
       call on dirfile (which might be GD_E_OK, indicating no error) can be obtained  by  calling
       gd_error(3).

RETURN VALUE

       The  gd_error_count()  function  always  returns  the number of GetData errors encountered
       since the last time it was called, or since the dirfile was created. This will be zero, if
       no error has occurred over the given time.

HISTORY

       The gd_error_count() function appeared in GetData-0.8.0.

SEE ALSO

       gd_error(3), gd_error_string(3)