Contents Up Previous Next

wxHTTP

Derived from

wxProtocol

Include files

<wx/protocol/http.h>

See also

wxSocketBase, wxURL

wxHTTP::GetResponse
wxHTTP::GetInputStream
wxHTTP::SetHeader
wxHTTP::GetHeader


wxHTTP::GetResponse

int GetResponse() const

Returns the HTTP response code returned by the server. Please refer to the RFC 2616 for the list of the responses.


wxHTTP::GetInputStream

wxInputStream * GetInputStream(const wxString& path)

Creates a new input stream on the the specified path. You can use all except the seek functionality of wxStream. Seek isn't available on all streams. For example, http or ftp streams doesn't deal with it. Other functions like Tell and SeekI for this sort of stream. You will be notified when the EOF is reached by an error.

Note

You can know the size of the file you are getting using wxStreamBase::GetSize(). But there is a limitation: as HTTP servers aren't obliged to pass the size of the file, in some case, you will be returned 0xfffffff by GetSize(). In these cases, you should use the value returned by wxInputStream::LastRead(): this value will be 0 when the stream is finished.

Return value

Returns the initialized stream. You will have to delete it yourself once you don't use it anymore. The destructor closes the network connection. The next time you will try to get a file the network connection will have to be reestablished: but you don't have to take care of this wxHTTP reestablishes it automatically.

See also

wxInputStream


wxHTTP::SetHeader

void SetHeader(const wxString& header, const wxString& h_data)

It sets data of a field to be sent during the next request to the HTTP server. The field name is specified by header and the content by h_data. This is a low level function and it assumes that you know what you are doing.


wxHTTP::GetHeader

wxString GetHeader(const wxString& header)

Returns the data attached with a field whose name is specified by header. If the field doesn't exist, it will return an empty string and not a NULL string.

Note

The header is not case-sensitive: I mean that "CONTENT-TYPE" and "content-type" represent the same header.