NAME¶
Ns_ConnGetStatus, Ns_ConnSetStatus - Routines to manage the HTTP response status
SYNOPSIS¶
#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);
SEE ALSO¶
Ns_ConnGetType(3),
Ns_ConnSetType(3),
Ns_ConnFlush(3),
Ns_ConnFlushDirect(3),
Ns_ConnSetRequiredHeaders(3),
Ns_ConnQueueHeaders(3), ns_conn(n)
KEYWORDS¶
connectionn, response, status