]> git.saurik.com Git - wxWidgets.git/blame_incremental - docs/latex/wx/protocol.tex
added null pointer check and assert
[wxWidgets.git] / docs / latex / wx / protocol.tex
... / ...
CommitLineData
1\section{\class{wxProtocol}}\label{wxprotocol}
2
3\wxheading{Derived from}
4
5\helpref{wxSocketClient}{wxsocketclient}
6\helpref{wxSocketBase}{wxsocketbase}
7\helpref{wxObject}{wxobject}
8
9\wxheading{Include files}
10
11<wx/protocol/protocol.h>
12
13\wxheading{Library}
14
15\helpref{wxNet}{librarieslist}
16
17\wxheading{See also}
18
19\helpref{wxSocketBase}{wxsocketbase}, \helpref{wxURL}{wxurl}
20
21% ----------------------------------------------------------------------------
22% Members
23% ----------------------------------------------------------------------------
24
25\latexignore{\rtfignore{\wxheading{Members}}}
26
27\membersection{wxProtocol::Reconnect}\label{wxprotocolreconnect}
28
29\func{bool}{Reconnect}{\void}
30
31Tries to reestablish a previous opened connection (close and renegotiate connection).
32
33\wxheading{Return value}
34
35true, if the connection is established, else false.
36
37% ----------------------------------------------------------------------------
38\membersection{wxProtocol::GetInputStream}\label{wxprotocolgetinput}
39
40\func{wxInputStream *}{GetInputStream}{\param{const wxString\&}{ path}}
41
42Creates a new input stream on the specified path. You can use all but seek
43functionality of wxStream. Seek isn't available on all streams. For example,
44HTTP or FTP streams don't deal with it. Other functions like StreamSize and
45Tell aren't available for the moment for this sort of stream.
46You will be notified when the EOF is reached by an error.
47
48\wxheading{Return value}
49
50Returns the initialized stream. You will have to delete it yourself once you
51don't use it anymore. The destructor closes the network connection.
52
53\wxheading{See also}
54
55\helpref{wxInputStream}{wxinputstream}
56
57% ----------------------------------------------------------------------------
58\membersection{wxProtocol::Abort}\label{wxprotocolabort}
59
60\func{bool}{Abort}{\void}
61
62Abort the current stream.
63
64\wxheading{Warning}
65
66It is advised to destroy the input stream instead of aborting the stream this way.
67
68\wxheading{Return value}
69
70Returns true, if successful, else false.
71
72% ----------------------------------------------------------------------------
73\membersection{wxProtocol::GetError}\label{wxprotocolgeterror}
74
75\func{wxProtocolError}{GetError}{\void}
76
77Returns the last occurred error.
78
79\twocolwidtha{7cm}
80\begin{twocollist}\itemsep=0pt
81\twocolitem{{\bf wxPROTO\_NOERR}}{No error.}
82\twocolitem{{\bf wxPROTO\_NETERR}}{A generic network error occurred.}
83\twocolitem{{\bf wxPROTO\_PROTERR}}{An error occurred during negotiation.}
84\twocolitem{{\bf wxPROTO\_CONNERR}}{The client failed to connect the server.}
85\twocolitem{{\bf wxPROTO\_INVVAL}}{Invalid value.}
86\twocolitem{{\bf wxPROTO\_NOHNDLR}}{.}
87\twocolitem{{\bf wxPROTO\_NOFILE}}{The remote file doesn't exist.}
88\twocolitem{{\bf wxPROTO\_ABRT}}{Last action aborted.}
89\twocolitem{{\bf wxPROTO\_RCNCT}}{An error occurred during reconnection.}
90\twocolitem{{\bf wxPROTO\_STREAM}}{Someone tried to send a command during a transfer.}
91\end{twocollist}
92
93% ----------------------------------------------------------------------------
94\membersection{wxProtocol::GetContentType}\label{wxprotocolgetcontenttype}
95
96\func{wxString}{GetContentType}{\void}
97
98Returns the type of the content of the last opened stream. It is a mime-type.
99
100% ----------------------------------------------------------------------------
101\membersection{wxProtocol::SetUser}\label{wxprotocolsetuser}
102
103\func{void }{SetUser}{\param{const wxString\&}{ user}}
104
105Sets the authentication user. It is mainly useful when FTP is used.
106
107\membersection{wxProtocol::SetPassword}\label{wxprotocolsetpassword}
108
109\func{void}{SetPassword}{\param{const wxString\&}{ user}}
110
111Sets the authentication password. It is mainly useful when FTP is used.
112