Previous

Next

Function xn_line_get

This function reads a line sent by the web browser from a user-supplied Post callback.

int xn_line_get(struct io_context *   io_context, 
                char              * * buffer, 
                long                  wait, 
                int                   type);

Parameters

io_context

I/O context passed to the user-supplied Post callback.

buffer

Pointer to a string pointer to receive a pointer to the available data.

wait

Maximum number of seconds to wait for the data.

type

Should be set to GET_BUF to return the next available packet or GET_LINE to read up to the next end of line.

return value

On error, returns SOCKET_ERROR. If the port is closed and no data is returned, the return value is -2. Otherwise, the count of bytes available at *buffer is returned.

If GET_LINE is used, this function continually reads characters until "\r\n" is encountered or until the buffer is full. The data returned is zero terminated; the "\r\n" is not saved in *buffer. This function waits at most wait seconds for data to be available. Post callbacks should call this routine to retrieve data from the browser.

Web Server

Function http_set_browser_list

Function xn_line_put