1999-02-26 13:51:51 -05:00
|
|
|
\section{\class{wxHTTP}}\label{wxhttp}
|
|
|
|
|
|
|
|
\wxheading{Derived from}
|
|
|
|
|
|
|
|
\helpref{wxProtocol}{wxprotocol}
|
|
|
|
|
|
|
|
\wxheading{Include files}
|
|
|
|
|
|
|
|
<wx/protocol/http.h>
|
|
|
|
|
|
|
|
\wxheading{See also}
|
|
|
|
|
|
|
|
\helpref{wxSocketBase}{wxsocketbase}, \helpref{wxURL}{wxurl}
|
|
|
|
|
|
|
|
% ----------------------------------------------------------------------------
|
|
|
|
% Members
|
|
|
|
% ----------------------------------------------------------------------------
|
|
|
|
|
|
|
|
% ----------------------------------------------------------------------------
|
2003-09-20 19:55:32 -04:00
|
|
|
\membersection{wxHTTP::GetResponse}\label{wxhttpgetresponse}
|
|
|
|
|
|
|
|
\constfunc{int}{GetResponse}{\void}
|
|
|
|
|
2006-02-13 10:18:35 -05:00
|
|
|
Returns the HTTP response code returned by the server. Please refer to
|
|
|
|
\urlref{RFC 2616}{http://www.faqs.org/rfcs/rfc2616.html} for the list of responses.
|
2003-09-20 19:55:32 -04:00
|
|
|
|
|
|
|
|
1999-02-26 17:22:13 -05:00
|
|
|
\membersection{wxHTTP::GetInputStream}\label{wxhttpgetinputstream}
|
1999-02-26 13:51:51 -05:00
|
|
|
|
|
|
|
\func{wxInputStream *}{GetInputStream}{\param{const wxString\&}{ path}}
|
|
|
|
|
2005-04-08 10:34:30 -04:00
|
|
|
Creates a new input stream on the specified path. You can use all except the seek
|
1999-02-26 17:22:13 -05:00
|
|
|
functionality of wxStream. Seek isn't available on all streams. For example,
|
1999-07-30 13:54:18 -04:00
|
|
|
http or ftp streams doesn't deal with it. Other functions like Tell and SeekI
|
|
|
|
for this sort of stream.
|
1999-02-26 13:51:51 -05:00
|
|
|
You will be notified when the EOF is reached by an error.
|
|
|
|
|
1999-07-30 13:54:18 -04:00
|
|
|
\wxheading{Note}
|
|
|
|
|
|
|
|
You can know the size of the file you are getting using \helpref{wxStreamBase::GetSize()}{wxstreambasegetsize}.
|
2002-06-07 16:15:28 -04:00
|
|
|
But there is a limitation: as HTTP servers aren't obliged to pass the size of
|
1999-07-30 13:54:18 -04:00
|
|
|
the file, in some case, you will be returned 0xfffffff by GetSize(). In these
|
|
|
|
cases, you should use the value returned by \helpref{wxInputStream::LastRead()}{wxinputstreamlastread}:
|
|
|
|
this value will be 0 when the stream is finished.
|
|
|
|
|
1999-02-26 13:51:51 -05:00
|
|
|
\wxheading{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
|
2006-02-13 10:18:35 -05:00
|
|
|
to be reestablished: but you don't have to take care of this since wxHTTP reestablishes it automatically.
|
1999-02-26 13:51:51 -05:00
|
|
|
|
|
|
|
\wxheading{See also}
|
|
|
|
|
|
|
|
\helpref{wxInputStream}{wxinputstream}
|
|
|
|
|
|
|
|
% ----------------------------------------------------------------------------
|
|
|
|
|
2004-09-29 07:25:34 -04:00
|
|
|
\membersection{wxHTTP::SetHeader}\label{wxhttpsetheader}
|
1999-02-26 13:51:51 -05:00
|
|
|
|
1999-03-13 15:14:37 -05:00
|
|
|
\func{void}{SetHeader}{\param{const wxString\&}{ header}, \param{const wxString\&}{ h\_data}}
|
1999-02-26 13:51:51 -05:00
|
|
|
|
|
|
|
It sets data of a field to be sent during the next request to the HTTP server. The field
|
1999-12-24 18:40:13 -05:00
|
|
|
name is specified by {\it header} and the content by {\it h\_data}.
|
1999-02-26 13:51:51 -05:00
|
|
|
This is a low level function and it assumes that you know what you are doing.
|
|
|
|
|
2004-09-29 07:25:34 -04:00
|
|
|
\membersection{wxHTTP::GetHeader}\label{wxhttpgetheader}
|
1999-02-26 17:22:13 -05:00
|
|
|
|
1999-02-26 13:51:51 -05:00
|
|
|
\func{wxString}{GetHeader}{\param{const wxString\&}{ header}}
|
|
|
|
|
1999-12-24 18:40:13 -05:00
|
|
|
Returns the data attached with a field whose name is specified by {\it header}.
|
1999-02-26 13:51:51 -05:00
|
|
|
If the field doesn't exist, it will return an empty string and not a NULL string.
|
1999-02-26 17:22:13 -05:00
|
|
|
|
1999-07-30 13:54:18 -04:00
|
|
|
\wxheading{Note}
|
|
|
|
|
2006-02-13 10:18:35 -05:00
|
|
|
The header is not case-sensitive, i.e. "CONTENT-TYPE" and "content-type"
|
1999-07-30 13:54:18 -04:00
|
|
|
represent the same header.
|
1999-08-05 18:05:15 -04:00
|
|
|
|