get_error_string

Langue: en

Autres versions - même langue

Version: 8 December 2008 (fedora - 05/07/09)

Section: 3 (Bibliothèques de fonctions)

NAME

get_error_string --- report a getdata library error

SYNOPSIS

#include <getdata.h>
char *get_error_string(const DIRFILE *dirfile, char *buffer, size_t buflen);

DESCRIPTION

The get_error_string() function returns a string describing the last dirfile error encountered while operating on dirfile. The string is written to the user-supplied buffer buffer. At most buflen characters will be written, including a terminating null. The numeric dirfile error itself may be obtained by calling get_error(3).

The dirfile argument should point to a DIRFILE object previously created by a call to dirfile_open(3).

RETURN VALUE

The get_error_string() function returns buffer, or NULL if buflen is less than one. The error state of dirfile is unchanged.

SEE ALSO

dirfile_open(3), get_error(3).