Utilities

Utility functions include platform-independent, thread-safe versions of many standard library functions (such as string manipulation), as well as new utilities useful for NSAPI.

• daemon_atrestart (UNIX only) registers a user function to be called when the server is sent a restart signal (HUP) or at shutdown.

• condvar_init gets the next line (up to a LF or CRLF) from a buffer.

• util_hostname gets the local host name as a fully qualified domain name.

• util_later_than compares two dates.

• util_sprintf is the same as the standard library routine sprintf().

• util_strftime is the same as the standard library routine strftime().

• util_uri_escape converts the special characters in a string into URI-escaped format.

• util_uri_unescape converts the URI-escaped characters in a string back into special characters.

You cannot use an embedded null in a string, because NSAPI functions assume that a null is the end of the string. Therefore, passing unicode-encoded content through an NSAPI plug-in doesn’t work.