SysTutorials

Linux Manual Pages › Section 3

ne_get_error(3)

ne_get_error, ne_set_error – error handling for HTTP sessions

Synopsis

#include <ne_session.h>
const char *ne_get_error(ne_sesssion *session);
void ne_set_error(ne_sesssion *session, const char *format, ...);

Description

The session error string is used to store any human-readable error information associated with any errors which occur whilst using the HTTP session.

The ne_get_error function returns the current session error string. This string persists only until it is changed by a subsequent operation on the session. If localisation was enabled at build time, and if necessary enabled at run-time if necessary using ne_i18n_init, the returned string may have been translated into the user’s current locale.

The ne_set_error function can be used to set a new session error string, using a printf-style format string interface.

Return Value

ne_set_error returns a constant NUL-terminated string. In the default English locale, the returned string will not have a terminating “.” period character.

Examples

Retrieve the current error string: ne_session *sess = ne_session_create(…);
…
ne_set_error(sess, "Response missing header %s", "somestring"); Set a new error string:

ne_session *sess = ne_session_create(...);
...
ne_set_error(sess, "Response missing header %s", "somestring");

Author

Joe Orton <neon [at] lists.manyfish.co.uk>

Author.

Copyright