Other Alias
Ns_ConnGetStatusSYNOPSIS
#include "ns.h"
int
Ns_ConnGetStatus(conn)
void
Ns_ConnSetStatus(conn, status)
ARGUMENTS
-
Ns_Conn conn (in)
Pointer to open connection. -
int status (in)
Integer HTTP status code.
DESCRIPTION
These routines manage the HTTP response code sent to the client in a later call to Ns_ConnFlush or Ns_ConnFlushDirect. Higher level routines such as the Ns_ConnReturn functions normally call these routines automatically using standard HTTP status codes and the Ns_ConnQueueHeaders routine can be used to set the status code for lower level code which bypasses Ns_ConnFlush.
- int Ns_ConnGetStatus(conn)
-
Return the current HTTP status to be sent.
- int Ns_ConnSetStatus(conn, status)
-
Set the status code to be sent in the response, for example, 200
for a normal "OK" response. A later call to Ns_ConnFlush
will construct the appropriate HTTP response including the given
status with the cooresponding string status code.
EXAMPLES
The following example demonstrates setting an odd status code followed by a call to Ns_ConnFlushDirect to send some data:
-
Ns_ConnSetStatus(conn, 600); Ns_ConnSetType(conn, "text/plain"); Ns_ConnFlushDirect(conn, "hello", 5, 0);
The following should provide similar results:
-
Ns_ConnSetRequiredHeaders(conn, "text/plain", 5); Ns_ConnQueueHeaders(conn, 600); Ns_ConnPuts(conn, "hello"); Ns_ConnClose(conn);
KEYWORDS
connectionn, response, status