gd_error_count(3)

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)


Last updated on 25 December 2016 for GetData Version 0.10.0.