ne_i18n_init(3) [debian man page]

NE_I18N_INIT(3) 						neon API reference						   NE_I18N_INIT(3)

NAME

       ne_i18n_init - functions to initialize internationalization support

SYNOPSIS

       #include <ne_i18n.h>

       void ne_i18n_init(const char *encoding);

DESCRIPTION

       The ne_i18n_init function can be used to enable support for translated messages in the neon library. The encoding parameter, if non-NULL,
       specifies the character encoding required for generated translated string. If it is NULL, the appropriate character encoding for the
       process locale will be used.

       This call is only strictly necessary if either:

	1. neon has been installed into a different prefix than the gettext implementation on which it depends for i18n purposes, or

	2. the caller requires that translated messages are in a particular character encoding.

       If ne_i18n_init is never called, the message catalogs will not be found if case (a) applies (and so English error messages will be used),
       and will use the default character encoding specified by the process locale. The library will otherwise operate correctly.

       Note that the encoding used is a process-global setting and so results may be unexpected if other users of neon within the process call
       ne_i18n_init with a different encoding parameter.

SEE ALSO

       ne_sock_init

AUTHOR

       Joe Orton <neon@lists.manyfish.co.uk>
	   Author.

COPYRIGHT

neon 0.29.6							    3 May 2011							   NE_I18N_INIT(3)

NE_GET_ERROR(3) 						neon API reference						   NE_GET_ERROR(3)

NAME

       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(...);
	   ...
	   printf("Error was: %s
", ne_get_error(sess));

       Set a new error string:

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

AUTHOR

       Joe Orton <neon@lists.manyfish.co.uk>
	   Author.

COPYRIGHT

neon 0.29.6							    3 May 2011							   NE_GET_ERROR(3)