get_error_string (3) - Linux Manuals

get_error_string: report a getdata library error

Command to display get_error_string manual in Linux: $ man 3 get_error_string

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. This always includes a terminating null byte, even if the error string was truncated. 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.