______________________________________________________________________________
Ns_ConnGetStatus, Ns_ConnSetStatus − Routines to manage the HTTP response status
#include "ns.h"
int
Ns_ConnGetStatus(conn)
void
Ns_ConnSetStatus(conn, status)
Ns_Conn conn (in) |
Pointer to open connection. |
|||
int status (in) |
Integer HTTP status code. |
_________________________________________________________________
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.
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); |
Ns_ConnGetType(3), Ns_ConnSetType(3), Ns_ConnFlush(3), Ns_ConnFlushDirect(3), Ns_ConnSetRequiredHeaders(3), Ns_ConnQueueHeaders(3), ns_conn(n)
connectionn, response, status