You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
694 lines
42 KiB
694 lines
42 KiB
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
|
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/src/network/qftp.cpp:1063 -->
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
|
<title>TQFtp Class</title>
|
|
<style type="text/css"><!--
|
|
fn { margin-left: 1cm; text-indent: -1cm; }
|
|
a:link { color: #004faf; text-decoration: none }
|
|
a:visited { color: #672967; text-decoration: none }
|
|
body { background: #ffffff; color: black; }
|
|
--></style>
|
|
</head>
|
|
<body>
|
|
|
|
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
|
<tr bgcolor="#E5E5E5">
|
|
<td valign=center>
|
|
<a href="index.html">
|
|
<font color="#004faf">Home</font></a>
|
|
| <a href="classes.html">
|
|
<font color="#004faf">All Classes</font></a>
|
|
| <a href="mainclasses.html">
|
|
<font color="#004faf">Main Classes</font></a>
|
|
| <a href="annotated.html">
|
|
<font color="#004faf">Annotated</font></a>
|
|
| <a href="groups.html">
|
|
<font color="#004faf">Grouped Classes</font></a>
|
|
| <a href="functions.html">
|
|
<font color="#004faf">Functions</font></a>
|
|
</td>
|
|
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>TQFtp Class Reference<br><small>[<a href="network.html">network module</a>]</small></h1>
|
|
|
|
<p>The TQFtp class provides an implementation of the FTP protocol.
|
|
<a href="#details">More...</a>
|
|
<p><tt>#include <<a href="qftp-h.html">qftp.h</a>></tt>
|
|
<p>Inherits <a href="qnetworkprotocol.html">TQNetworkProtocol</a>.
|
|
<p><a href="qftp-members.html">List of all member functions.</a>
|
|
<h2>Public Members</h2>
|
|
<ul>
|
|
<li class=fn><a href="#TQFtp"><b>TQFtp</b></a> ()</li>
|
|
<li class=fn><a href="#TQFtp-2"><b>TQFtp</b></a> ( TQObject * parent, const char * name = 0 )</li>
|
|
<li class=fn>virtual <a href="#~TQFtp"><b>~TQFtp</b></a> ()</li>
|
|
<li class=fn>enum <a href="#State-enum"><b>State</b></a> { Unconnected, HostLookup, Connecting, Connected, LoggedIn, Closing }</li>
|
|
<li class=fn>enum <a href="#Error-enum"><b>Error</b></a> { NoError, UnknownError, HostNotFound, ConnectionRefused, NotConnected }</li>
|
|
<li class=fn>enum <a href="#Command-enum"><b>Command</b></a> { None, ConnectToHost, Login, Close, List, Cd, Get, Put, Remove, Mkdir, Rmdir, Rename, RawCommand }</li>
|
|
<li class=fn>int <a href="#connectToHost"><b>connectToHost</b></a> ( const TQString & host, Q_UINT16 port = 21 )</li>
|
|
<li class=fn>int <a href="#login"><b>login</b></a> ( const TQString & user = TQString::null, const TQString & password = TQString::null )</li>
|
|
<li class=fn>int <a href="#close"><b>close</b></a> ()</li>
|
|
<li class=fn>int <a href="#list"><b>list</b></a> ( const TQString & dir = TQString::null )</li>
|
|
<li class=fn>int <a href="#cd"><b>cd</b></a> ( const TQString & dir )</li>
|
|
<li class=fn>int <a href="#get"><b>get</b></a> ( const TQString & file, TQIODevice * dev = 0 )</li>
|
|
<li class=fn>int <a href="#put-2"><b>put</b></a> ( const TQByteArray & data, const TQString & file )</li>
|
|
<li class=fn>int <a href="#put"><b>put</b></a> ( TQIODevice * dev, const TQString & file )</li>
|
|
<li class=fn>int <a href="#remove"><b>remove</b></a> ( const TQString & file )</li>
|
|
<li class=fn>int <a href="#mkdir"><b>mkdir</b></a> ( const TQString & dir )</li>
|
|
<li class=fn>int <a href="#rmdir"><b>rmdir</b></a> ( const TQString & dir )</li>
|
|
<li class=fn>int <a href="#rename"><b>rename</b></a> ( const TQString & oldname, const TQString & newname )</li>
|
|
<li class=fn>int <a href="#rawCommand"><b>rawCommand</b></a> ( const TQString & command )</li>
|
|
<li class=fn>Q_ULONG <a href="#bytesAvailable"><b>bytesAvailable</b></a> () const</li>
|
|
<li class=fn>Q_LONG <a href="#readBlock"><b>readBlock</b></a> ( char * data, Q_ULONG maxlen )</li>
|
|
<li class=fn>TQByteArray <a href="#readAll"><b>readAll</b></a> ()</li>
|
|
<li class=fn>int <a href="#currentId"><b>currentId</b></a> () const</li>
|
|
<li class=fn>TQIODevice * <a href="#currentDevice"><b>currentDevice</b></a> () const</li>
|
|
<li class=fn>Command <a href="#currentCommand"><b>currentCommand</b></a> () const</li>
|
|
<li class=fn>bool <a href="#hasPendingCommands"><b>hasPendingCommands</b></a> () const</li>
|
|
<li class=fn>void <a href="#clearPendingCommands"><b>clearPendingCommands</b></a> ()</li>
|
|
<li class=fn>State <a href="#state"><b>state</b></a> () const</li>
|
|
<li class=fn>Error <a href="#error"><b>error</b></a> () const</li>
|
|
<li class=fn>TQString <a href="#errorString"><b>errorString</b></a> () const</li>
|
|
</ul>
|
|
<h2>Public Slots</h2>
|
|
<ul>
|
|
<li class=fn>void <a href="#abort"><b>abort</b></a> ()</li>
|
|
</ul>
|
|
<h2>Signals</h2>
|
|
<ul>
|
|
<li class=fn>void <a href="#stateChanged"><b>stateChanged</b></a> ( int state )</li>
|
|
<li class=fn>void <a href="#listInfo"><b>listInfo</b></a> ( const TQUrlInfo & i )</li>
|
|
<li class=fn>void <a href="#readyRead"><b>readyRead</b></a> ()</li>
|
|
<li class=fn>void <a href="#dataTransferProgress"><b>dataTransferProgress</b></a> ( int done, int total )</li>
|
|
<li class=fn>void <a href="#rawCommandReply"><b>rawCommandReply</b></a> ( int replyCode, const TQString & detail )</li>
|
|
<li class=fn>void <a href="#commandStarted"><b>commandStarted</b></a> ( int id )</li>
|
|
<li class=fn>void <a href="#commandFinished"><b>commandFinished</b></a> ( int id, bool error )</li>
|
|
<li class=fn>void <a href="#done"><b>done</b></a> ( bool error )</li>
|
|
</ul>
|
|
<hr><a name="details"></a><h2>Detailed Description</h2>
|
|
|
|
|
|
The TQFtp class provides an implementation of the FTP protocol.
|
|
|
|
<p>
|
|
|
|
<p> This class provides two different interfaces: one is the
|
|
<a href="qnetworkprotocol.html">TQNetworkProtocol</a> interface that allows you to use FTP through the
|
|
<a href="qurloperator.html">TQUrlOperator</a> abstraction. The other is a direct interface to FTP
|
|
that gives you lower-level access to the FTP protocol for finer
|
|
control. Using the direct interface you can also execute arbitrary
|
|
FTP commands.
|
|
<p> Don't mix the two interfaces, since the behavior is not
|
|
well-defined.
|
|
<p> If you want to use TQFtp with the TQNetworkProtocol interface, you
|
|
do not use it directly, but rather through a TQUrlOperator, for
|
|
example:
|
|
<p> <pre>
|
|
<a href="qurloperator.html">TQUrlOperator</a> op( "ftp://ftp.trolltech.com" );
|
|
op.<a href="qurloperator.html#listChildren">listChildren</a>(); // Asks the server to provide a directory listing
|
|
</pre>
|
|
|
|
<p> This code will only work if the TQFtp class is registered; to
|
|
register the class, you must call <a href="qurloperator.html#qInitNetworkProtocols">qInitNetworkProtocols</a>() before
|
|
using a TQUrlOperator with TQFtp.
|
|
<p> The rest of this descrption describes the direct interface to FTP.
|
|
<p> The class works asynchronously, so there are no blocking
|
|
functions. If an operation cannot be executed immediately, the
|
|
function will still return straight away and the operation will be
|
|
scheduled for later execution. The results of scheduled operations
|
|
are reported via signals. This approach depends on the event loop
|
|
being in operation.
|
|
<p> The operations that can be scheduled (they are called "commands"
|
|
in the rest of the documentation) are the following:
|
|
<a href="#connectToHost">connectToHost</a>(), <a href="#login">login</a>(), <a href="#close">close</a>(), <a href="#list">list</a>(), <a href="#cd">cd</a>(), <a href="#get">get</a>(), <a href="#put">put</a>(),
|
|
<a href="#remove">remove</a>(), <a href="#mkdir">mkdir</a>(), <a href="#rmdir">rmdir</a>(), <a href="#rename">rename</a>() and <a href="#rawCommand">rawCommand</a>().
|
|
<p> All of these commands return a unique identifier that allows you
|
|
to keep track of the command that is currently being executed.
|
|
When the execution of a command starts, the <a href="#commandStarted">commandStarted</a>()
|
|
signal with the command's identifier is emitted. When the command
|
|
is finished, the <a href="#commandFinished">commandFinished</a>() signal is emitted with the
|
|
command's identifier and a bool that indicates whether the command
|
|
finished with an error.
|
|
<p> In some cases, you might want to execute a sequence of commands,
|
|
e.g. if you want to connect and login to a FTP server. This is
|
|
simply achieved:
|
|
<p> <pre>
|
|
TQFtp *ftp = new TQFtp( this ); // this is an optional TQObject parent
|
|
ftp-><a href="#connectToHost">connectToHost</a>( "ftp.trolltech.com" );
|
|
ftp-><a href="#login">login</a>();
|
|
</pre>
|
|
|
|
<p> In this case two FTP commands have been scheduled. When the last
|
|
scheduled command has finished, a <a href="#done">done</a>() signal is emitted with
|
|
a bool argument that tells you whether the sequence finished with
|
|
an error.
|
|
<p> If an error occurs during the execution of one of the commands in
|
|
a sequence of commands, all the pending commands (i.e. scheduled,
|
|
but not yet executed commands) are cleared and no signals are
|
|
emitted for them.
|
|
<p> Some commands, e.g. <a href="#list">list</a>(), emit additional signals to report
|
|
their results.
|
|
<p> Example: If you want to download the INSTALL file from Trolltech's
|
|
FTP server, you would write this:
|
|
<p> <pre>
|
|
ftp->connectToHost( "ftp.trolltech.com" ); // id == 1
|
|
ftp->login(); // id == 2
|
|
ftp->cd( "qt" ); // id == 3
|
|
ftp->get( "INSTALL" ); // id == 4
|
|
ftp->close(); // id == 5
|
|
</pre>
|
|
|
|
<p> For this example the following sequence of signals is emitted
|
|
(with small variations, depending on network traffic, etc.):
|
|
<p> <pre>
|
|
<a href="qnetworkprotocol.html#start">start</a>( 1 )
|
|
<a href="#stateChanged">stateChanged</a>( <a href="#State-enum">HostLookup</a> )
|
|
<a href="#stateChanged">stateChanged</a>( <a href="#State-enum">Connecting</a> )
|
|
<a href="#stateChanged">stateChanged</a>( <a href="#State-enum">Connected</a> )
|
|
<a href="qnetworkprotocol.html#finished">finished</a>( 1, FALSE )
|
|
|
|
<a href="qnetworkprotocol.html#start">start</a>( 2 )
|
|
<a href="#stateChanged">stateChanged</a>( <a href="#State-enum">LoggedIn</a> )
|
|
<a href="qnetworkprotocol.html#finished">finished</a>( 2, FALSE )
|
|
|
|
<a href="qnetworkprotocol.html#start">start</a>( 3 )
|
|
<a href="qnetworkprotocol.html#finished">finished</a>( 3, FALSE )
|
|
|
|
<a href="qnetworkprotocol.html#start">start</a>( 4 )
|
|
<a href="#dataTransferProgress">dataTransferProgress</a>( 0, 3798 )
|
|
<a href="#dataTransferProgress">dataTransferProgress</a>( 2896, 3798 )
|
|
<a href="#readyRead">readyRead</a>()
|
|
<a href="#dataTransferProgress">dataTransferProgress</a>( 3798, 3798 )
|
|
<a href="#readyRead">readyRead</a>()
|
|
<a href="qnetworkprotocol.html#finished">finished</a>( 4, FALSE )
|
|
|
|
<a href="qnetworkprotocol.html#start">start</a>( 5 )
|
|
<a href="#stateChanged">stateChanged</a>( <a href="#State-enum">Closing</a> )
|
|
<a href="#stateChanged">stateChanged</a>( <a href="#State-enum">Unconnected</a> )
|
|
<a href="qnetworkprotocol.html#finished">finished</a>( 5, FALSE )
|
|
|
|
<a href="#done">done</a>( FALSE )
|
|
</pre>
|
|
|
|
<p> The <a href="#dataTransferProgress">dataTransferProgress</a>() signal in the above example is useful
|
|
if you want to show a <a href="qprogressbar.html">progressbar</a> to
|
|
inform the user about the progress of the download. The
|
|
<a href="#readyRead">readyRead</a>() signal tells you that there is data ready to be read.
|
|
The amount of data can be queried then with the <a href="#bytesAvailable">bytesAvailable</a>()
|
|
function and it can be read with the <a href="#readBlock">readBlock</a>() or <a href="#readAll">readAll</a>()
|
|
function.
|
|
<p> If the login fails for the above example, the signals would look
|
|
like this:
|
|
<p> <pre>
|
|
<a href="qnetworkprotocol.html#start">start</a>( 1 )
|
|
<a href="#stateChanged">stateChanged</a>( <a href="#State-enum">HostLookup</a> )
|
|
<a href="#stateChanged">stateChanged</a>( <a href="#State-enum">Connecting</a> )
|
|
<a href="#stateChanged">stateChanged</a>( <a href="#State-enum">Connected</a> )
|
|
<a href="qnetworkprotocol.html#finished">finished</a>( 1, FALSE )
|
|
|
|
<a href="qnetworkprotocol.html#start">start</a>( 2 )
|
|
<a href="qnetworkprotocol.html#finished">finished</a>( 2, TRUE )
|
|
|
|
<a href="#done">done</a>( TRUE )
|
|
</pre>
|
|
|
|
<p> You can then get details about the error with the <a href="#error">error</a>() and
|
|
<a href="#errorString">errorString</a>() functions.
|
|
<p> The functions <a href="#currentId">currentId</a>() and <a href="#currentCommand">currentCommand</a>() provide more
|
|
information about the currently executing command.
|
|
<p> The functions <a href="#hasPendingCommands">hasPendingCommands</a>() and <a href="#clearPendingCommands">clearPendingCommands</a>()
|
|
allow you to query and clear the list of pending commands.
|
|
<p> The safest and easiest way to use the FTP protocol is to use
|
|
<a href="qurloperator.html">TQUrlOperator</a>() or the FTP commands described above. If you are an
|
|
experienced network programmer and want to have complete control
|
|
you can use <a href="#rawCommand">rawCommand</a>() to execute arbitrary FTP commands.
|
|
<p> <p>See also <a href="network.html">TQt Network Documentation</a>, <a href="qnetworkprotocol.html">TQNetworkProtocol</a>, <a href="qurloperator.html">TQUrlOperator</a>, <a href="qhttp.html">TQHttp</a>, and <a href="io.html">Input/Output and Networking</a>.
|
|
|
|
<hr><h2>Member Type Documentation</h2>
|
|
<h3 class=fn><a name="Command-enum"></a>TQFtp::Command</h3>
|
|
|
|
<p> This enum is used as the return value for the <a href="#currentCommand">currentCommand</a>() function.
|
|
This allows you to perform specific actions for particular
|
|
commands, e.g. in a FTP client, you might want to clear the
|
|
directory view when a <a href="#list">list</a>() command is started; in this case you
|
|
can simply check in the slot connected to the <a href="qnetworkprotocol.html#start">start</a>() signal if
|
|
the currentCommand() is <a href="#Command-enum">List</a>.
|
|
<ul>
|
|
<li><tt>TQFtp::None</tt> - No command is being executed.
|
|
<li><tt>TQFtp::ConnectToHost</tt> - <a href="#connectToHost">connectToHost</a>() is being executed.
|
|
<li><tt>TQFtp::Login</tt> - <a href="#login">login</a>() is being executed.
|
|
<li><tt>TQFtp::Close</tt> - <a href="#close">close</a>() is being executed.
|
|
<li><tt>TQFtp::List</tt> - list() is being executed.
|
|
<li><tt>TQFtp::Cd</tt> - <a href="#cd">cd</a>() is being executed.
|
|
<li><tt>TQFtp::Get</tt> - <a href="#get">get</a>() is being executed.
|
|
<li><tt>TQFtp::Put</tt> - <a href="#put">put</a>() is being executed.
|
|
<li><tt>TQFtp::Remove</tt> - <a href="#remove">remove</a>() is being executed.
|
|
<li><tt>TQFtp::Mkdir</tt> - <a href="#mkdir">mkdir</a>() is being executed.
|
|
<li><tt>TQFtp::Rmdir</tt> - <a href="#rmdir">rmdir</a>() is being executed.
|
|
<li><tt>TQFtp::Rename</tt> - <a href="#rename">rename</a>() is being executed.
|
|
<li><tt>TQFtp::RawCommand</tt> - <a href="#rawCommand">rawCommand</a>() is being executed.
|
|
</ul><p> <p>See also <a href="#currentCommand">currentCommand</a>().
|
|
|
|
<h3 class=fn><a name="Error-enum"></a>TQFtp::Error</h3>
|
|
|
|
<p> This enum identifies the error that occurred.
|
|
<ul>
|
|
<li><tt>TQFtp::NoError</tt> - No error occurred.
|
|
<li><tt>TQFtp::HostNotFound</tt> - The host name lookup failed.
|
|
<li><tt>TQFtp::ConnectionRefused</tt> - The server refused the connection.
|
|
<li><tt>TQFtp::NotConnected</tt> - Tried to send a command, but there is no connection to
|
|
a server.
|
|
<li><tt>TQFtp::UnknownError</tt> - An error other than those specified above
|
|
occurred.
|
|
</ul><p> <p>See also <a href="#error">error</a>().
|
|
|
|
<h3 class=fn><a name="State-enum"></a>TQFtp::State</h3>
|
|
|
|
<p> This enum defines the connection state:
|
|
<ul>
|
|
<li><tt>TQFtp::Unconnected</tt> - There is no connection to the host.
|
|
<li><tt>TQFtp::HostLookup</tt> - A host name lookup is in progress.
|
|
<li><tt>TQFtp::Connecting</tt> - An attempt to connect to the host is in progress.
|
|
<li><tt>TQFtp::Connected</tt> - Connection to the host has been achieved.
|
|
<li><tt>TQFtp::LoggedIn</tt> - Connection and user login have been achieved.
|
|
<li><tt>TQFtp::Closing</tt> - The connection is closing down, but it is not yet
|
|
closed. (The state will be <a href="#State-enum">Unconnected</a> when the connection is
|
|
closed.)
|
|
</ul><p> <p>See also <a href="#stateChanged">stateChanged</a>() and <a href="#state">state</a>().
|
|
|
|
<hr><h2>Member Function Documentation</h2>
|
|
<h3 class=fn><a name="TQFtp"></a>TQFtp::TQFtp ()
|
|
</h3>
|
|
Constructs a TQFtp object.
|
|
|
|
<h3 class=fn><a name="TQFtp-2"></a>TQFtp::TQFtp ( <a href="qobject.html">TQObject</a> * parent, const char * name = 0 )
|
|
</h3>
|
|
Constructs a TQFtp object. The <em>parent</em> and <em>name</em> parameters
|
|
are passed to the <a href="qobject.html">TQObject</a> constructor.
|
|
|
|
<h3 class=fn><a name="~TQFtp"></a>TQFtp::~TQFtp ()<tt> [virtual]</tt>
|
|
</h3>
|
|
Destructor.
|
|
|
|
<h3 class=fn>void <a name="abort"></a>TQFtp::abort ()<tt> [slot]</tt>
|
|
</h3>
|
|
Aborts the current command and deletes all scheduled commands.
|
|
<p> If there is an unfinished command (i.e. a command for which the
|
|
<a href="#commandStarted">commandStarted</a>() signal has been emitted, but for which the
|
|
<a href="#commandFinished">commandFinished</a>() signal has not been emitted), this function
|
|
sends an <tt>ABORT</tt> command to the server. When the server replies
|
|
that the command is aborted, the commandFinished() signal with the
|
|
<tt>error</tt> argument set to <tt>TRUE</tt> is emitted for the command. Due
|
|
to timing issues, it is possible that the command had already
|
|
finished before the abort request reached the server, in which
|
|
case, the commandFinished() signal is emitted with the <tt>error</tt>
|
|
argument set to <tt>FALSE</tt>.
|
|
<p> For all other commands that are affected by the <a href="#abort">abort</a>(), no
|
|
signals are emitted.
|
|
<p> If you don't start further FTP commands directly after the
|
|
abort(), there won't be any scheduled commands and the <a href="#done">done</a>()
|
|
signal is emitted.
|
|
<p> <b>Warning:</b> Some FTP servers, for example the BSD FTP daemon (version
|
|
0.3), wrongly return a positive reply even when an abort has
|
|
occurred. For these servers the commandFinished() signal has its
|
|
error flag set to <tt>FALSE</tt>, even though the command did not
|
|
complete successfully.
|
|
<p> <p>See also <a href="#clearPendingCommands">clearPendingCommands</a>().
|
|
|
|
<p>Example: <a href="ftpclient-example.html#x744">network/ftpclient/ftpmainwindow.ui.h</a>.
|
|
<h3 class=fn>Q_ULONG <a name="bytesAvailable"></a>TQFtp::bytesAvailable () const
|
|
</h3>
|
|
Returns the number of bytes that can be read from the data socket
|
|
at the moment.
|
|
<p> <p>See also <a href="#get">get</a>(), <a href="#readyRead">readyRead</a>(), <a href="#readBlock">readBlock</a>(), and <a href="#readAll">readAll</a>().
|
|
|
|
<h3 class=fn>int <a name="cd"></a>TQFtp::cd ( const <a href="qstring.html">TQString</a> & dir )
|
|
</h3>
|
|
Changes the working directory of the server to <em>dir</em>.
|
|
<p> The function does not block and returns immediately. The command
|
|
is scheduled, and its execution is performed asynchronously. The
|
|
function returns a unique identifier which is passed by
|
|
<a href="#commandStarted">commandStarted</a>() and <a href="#commandFinished">commandFinished</a>().
|
|
<p> When the command is started the commandStarted() signal is
|
|
emitted. When it is finished the commandFinished() signal is
|
|
emitted.
|
|
<p> <p>See also <a href="#commandStarted">commandStarted</a>() and <a href="#commandFinished">commandFinished</a>().
|
|
|
|
<p>Example: <a href="ftpclient-example.html#x745">network/ftpclient/ftpmainwindow.ui.h</a>.
|
|
<h3 class=fn>void <a name="clearPendingCommands"></a>TQFtp::clearPendingCommands ()
|
|
</h3>
|
|
Deletes all pending commands from the list of scheduled commands.
|
|
This does not affect the command that is being executed. If you
|
|
want to stop this this as well, use <a href="#abort">abort</a>().
|
|
<p> <p>See also <a href="#hasPendingCommands">hasPendingCommands</a>() and <a href="#abort">abort</a>().
|
|
|
|
<h3 class=fn>int <a name="close"></a>TQFtp::close ()
|
|
</h3>
|
|
Closes the connection to the FTP server.
|
|
<p> The <a href="#stateChanged">stateChanged</a>() signal is emitted when the state of the
|
|
connecting process changes, e.g. to <a href="#State-enum">Closing</a>, then <a href="#State-enum">Unconnected</a>.
|
|
<p> The function does not block and returns immediately. The command
|
|
is scheduled, and its execution is performed asynchronously. The
|
|
function returns a unique identifier which is passed by
|
|
<a href="#commandStarted">commandStarted</a>() and <a href="#commandFinished">commandFinished</a>().
|
|
<p> When the command is started the commandStarted() signal is
|
|
emitted. When it is finished the commandFinished() signal is
|
|
emitted.
|
|
<p> <p>See also <a href="#stateChanged">stateChanged</a>(), <a href="#commandStarted">commandStarted</a>(), and <a href="#commandFinished">commandFinished</a>().
|
|
|
|
<p>Example: <a href="ftpclient-example.html#x746">network/ftpclient/ftpmainwindow.ui.h</a>.
|
|
<h3 class=fn>void <a name="commandFinished"></a>TQFtp::commandFinished ( int id, bool error )<tt> [signal]</tt>
|
|
</h3>
|
|
|
|
<p> This signal is emitted when processing the command identified by
|
|
<em>id</em> has finished. <em>error</em> is TRUE if an error occurred during
|
|
the processing; otherwise <em>error</em> is FALSE.
|
|
<p> <p>See also <a href="#commandStarted">commandStarted</a>(), <a href="#done">done</a>(), <a href="#error">error</a>(), and <a href="#errorString">errorString</a>().
|
|
|
|
<p>Example: <a href="ftpclient-example.html#x747">network/ftpclient/ftpmainwindow.ui.h</a>.
|
|
<h3 class=fn>void <a name="commandStarted"></a>TQFtp::commandStarted ( int id )<tt> [signal]</tt>
|
|
</h3>
|
|
|
|
<p> This signal is emitted when processing the command identified by
|
|
<em>id</em> starts.
|
|
<p> <p>See also <a href="#commandFinished">commandFinished</a>() and <a href="#done">done</a>().
|
|
|
|
<p>Example: <a href="ftpclient-example.html#x748">network/ftpclient/ftpmainwindow.ui.h</a>.
|
|
<h3 class=fn>int <a name="connectToHost"></a>TQFtp::connectToHost ( const <a href="qstring.html">TQString</a> & host, Q_UINT16 port = 21 )
|
|
</h3>
|
|
Connects to the FTP server <em>host</em> using port <em>port</em>.
|
|
<p> The <a href="#stateChanged">stateChanged</a>() signal is emitted when the state of the
|
|
connecting process changes, e.g. to <a href="#State-enum">HostLookup</a>, then <a href="#State-enum">Connecting</a>, then <a href="#State-enum">Connected</a>.
|
|
<p> The function does not block and returns immediately. The command
|
|
is scheduled, and its execution is performed asynchronously. The
|
|
function returns a unique identifier which is passed by
|
|
<a href="#commandStarted">commandStarted</a>() and <a href="#commandFinished">commandFinished</a>().
|
|
<p> When the command is started the commandStarted() signal is
|
|
emitted. When it is finished the commandFinished() signal is
|
|
emitted.
|
|
<p> <p>See also <a href="#stateChanged">stateChanged</a>(), <a href="#commandStarted">commandStarted</a>(), and <a href="#commandFinished">commandFinished</a>().
|
|
|
|
<p>Example: <a href="ftpclient-example.html#x749">network/ftpclient/ftpmainwindow.ui.h</a>.
|
|
<h3 class=fn><a href="qftp.html#Command-enum">Command</a> <a name="currentCommand"></a>TQFtp::currentCommand () const
|
|
</h3>
|
|
Returns the command type of the FTP command being executed or <a href="#Command-enum">None</a> if there is no command being executed.
|
|
<p> <p>See also <a href="#currentId">currentId</a>().
|
|
|
|
<p>Example: <a href="ftpclient-example.html#x750">network/ftpclient/ftpmainwindow.ui.h</a>.
|
|
<h3 class=fn><a href="qiodevice.html">TQIODevice</a> * <a name="currentDevice"></a>TQFtp::currentDevice () const
|
|
</h3>
|
|
Returns the <a href="qiodevice.html">TQIODevice</a> pointer that is used by the FTP command to read data
|
|
from or store data to. If there is no current FTP command being executed or
|
|
if the command does not use an IO device, this function returns 0.
|
|
<p> This function can be used to delete the TQIODevice in the slot connected to
|
|
the <a href="#commandFinished">commandFinished</a>() signal.
|
|
<p> <p>See also <a href="#get">get</a>() and <a href="#put">put</a>().
|
|
|
|
<p>Example: <a href="ftpclient-example.html#x751">network/ftpclient/ftpmainwindow.ui.h</a>.
|
|
<h3 class=fn>int <a name="currentId"></a>TQFtp::currentId () const
|
|
</h3>
|
|
Returns the identifier of the FTP command that is being executed
|
|
or 0 if there is no command being executed.
|
|
<p> <p>See also <a href="#currentCommand">currentCommand</a>().
|
|
|
|
<h3 class=fn>void <a name="dataTransferProgress"></a>TQFtp::dataTransferProgress ( int done, int total )<tt> [signal]</tt>
|
|
</h3>
|
|
|
|
<p> This signal is emitted in response to a <a href="#get">get</a>() or <a href="#put">put</a>() request to
|
|
indicate the current progress of the download or upload.
|
|
<p> <em>done</em> is the amount of data that has already been transferred
|
|
and <em>total</em> is the total amount of data to be read or written. It
|
|
is possible that the TQFtp class is not able to determine the total
|
|
amount of data that should be transferred, in which case <em>total</em>
|
|
is 0. (If you connect this signal to a <a href="qprogressbar.html">TQProgressBar</a>, the progress
|
|
bar shows a busy indicator if the total is 0).
|
|
<p> <b>Warning:</b> <em>done</em> and <em>total</em> are not necessarily the size in
|
|
bytes, since for large files these values might need to be
|
|
"scaled" to avoid overflow.
|
|
<p> <p>See also <a href="#get">get</a>(), <a href="#put">put</a>(), and <a href="qprogressbar.html#progress-prop">TQProgressBar::progress</a>.
|
|
|
|
<p>Example: <a href="ftpclient-example.html#x752">network/ftpclient/ftpmainwindow.ui.h</a>.
|
|
<h3 class=fn>void <a name="done"></a>TQFtp::done ( bool error )<tt> [signal]</tt>
|
|
</h3>
|
|
|
|
<p> This signal is emitted when the last pending command has finished;
|
|
(it is emitted after the last command's <a href="#commandFinished">commandFinished</a>() signal).
|
|
<em>error</em> is TRUE if an error occurred during the processing;
|
|
otherwise <em>error</em> is FALSE.
|
|
<p> <p>See also <a href="#commandFinished">commandFinished</a>(), <a href="#error">error</a>(), and <a href="#errorString">errorString</a>().
|
|
|
|
<p>Example: <a href="ftpclient-example.html#x753">network/ftpclient/ftpmainwindow.ui.h</a>.
|
|
<h3 class=fn><a href="qftp.html#Error-enum">Error</a> <a name="error"></a>TQFtp::error () const
|
|
</h3>
|
|
Returns the last error that occurred. This is useful to find out
|
|
what when wrong when receiving a <a href="#commandFinished">commandFinished</a>() or a <a href="#done">done</a>()
|
|
signal with the <tt>error</tt> argument set to <tt>TRUE</tt>.
|
|
<p> If you start a new command, the error status is reset to <a href="#Error-enum">NoError</a>.
|
|
|
|
<h3 class=fn><a href="qstring.html">TQString</a> <a name="errorString"></a>TQFtp::errorString () const
|
|
</h3>
|
|
Returns a human-readable description of the last error that
|
|
occurred. This is useful for presenting a error message to the
|
|
user when receiving a <a href="#commandFinished">commandFinished</a>() or a <a href="#done">done</a>() signal with
|
|
the <tt>error</tt> argument set to <tt>TRUE</tt>.
|
|
<p> The error string is often (but not always) the reply from the
|
|
server, so it is not always possible to translate the string. If
|
|
the message comes from TQt, the string has already passed through
|
|
<a href="qobject.html#tr">tr</a>().
|
|
|
|
<p>Example: <a href="ftpclient-example.html#x754">network/ftpclient/ftpmainwindow.ui.h</a>.
|
|
<h3 class=fn>int <a name="get"></a>TQFtp::get ( const <a href="qstring.html">TQString</a> & file, <a href="qiodevice.html">TQIODevice</a> * dev = 0 )
|
|
</h3>
|
|
Downloads the file <em>file</em> from the server.
|
|
<p> If <em>dev</em> is 0, then the <a href="#readyRead">readyRead</a>() signal is emitted when there
|
|
is data available to read. You can then read the data with the
|
|
<a href="#readBlock">readBlock</a>() or <a href="#readAll">readAll</a>() functions.
|
|
<p> If <em>dev</em> is not 0, the data is written directly to the device <em>dev</em>. Make sure that the <em>dev</em> pointer is valid for the duration
|
|
of the operation (it is safe to delete it when the
|
|
<a href="#commandFinished">commandFinished</a>() signal is emitted). In this case the readyRead()
|
|
signal is <em>not</em> emitted and you cannot read data with the
|
|
readBlock() or readAll() functions.
|
|
<p> If you don't read the data immediately it becomes available, i.e.
|
|
when the readyRead() signal is emitted, it is still available
|
|
until the next command is started.
|
|
<p> For example, if you want to present the data to the user as soon
|
|
as there is something available, connect to the readyRead() signal
|
|
and read the data immediately. On the other hand, if you only want
|
|
to work with the complete data, you can connect to the
|
|
commandFinished() signal and read the data when the <a href="#get">get</a>() command
|
|
is finished.
|
|
<p> The function does not block and returns immediately. The command
|
|
is scheduled, and its execution is performed asynchronously. The
|
|
function returns a unique identifier which is passed by
|
|
<a href="#commandStarted">commandStarted</a>() and commandFinished().
|
|
<p> When the command is started the commandStarted() signal is
|
|
emitted. When it is finished the <a href="#commandFinished">commandFinished</a>() signal is
|
|
emitted.
|
|
<p> <p>See also <a href="#readyRead">readyRead</a>(), <a href="#dataTransferProgress">dataTransferProgress</a>(), <a href="#commandStarted">commandStarted</a>(), and <a href="#commandFinished">commandFinished</a>().
|
|
|
|
<p>Example: <a href="ftpclient-example.html#x755">network/ftpclient/ftpmainwindow.ui.h</a>.
|
|
<h3 class=fn>bool <a name="hasPendingCommands"></a>TQFtp::hasPendingCommands () const
|
|
</h3>
|
|
Returns TRUE if there are any commands scheduled that have not yet
|
|
been executed; otherwise returns FALSE.
|
|
<p> The command that is being executed is <em>not</em> considered as a
|
|
scheduled command.
|
|
<p> <p>See also <a href="#clearPendingCommands">clearPendingCommands</a>(), <a href="#currentId">currentId</a>(), and <a href="#currentCommand">currentCommand</a>().
|
|
|
|
<h3 class=fn>int <a name="list"></a>TQFtp::list ( const <a href="qstring.html">TQString</a> & dir = TQString::null )
|
|
</h3>
|
|
Lists the contents of directory <em>dir</em> on the FTP server. If <em>dir</em> is empty, it lists the contents of the current directory.
|
|
<p> The <a href="#listInfo">listInfo</a>() signal is emitted for each directory entry found.
|
|
<p> The function does not block and returns immediately. The command
|
|
is scheduled, and its execution is performed asynchronously. The
|
|
function returns a unique identifier which is passed by
|
|
<a href="#commandStarted">commandStarted</a>() and <a href="#commandFinished">commandFinished</a>().
|
|
<p> When the command is started the commandStarted() signal is
|
|
emitted. When it is finished the commandFinished() signal is
|
|
emitted.
|
|
<p> <p>See also <a href="#listInfo">listInfo</a>(), <a href="#commandStarted">commandStarted</a>(), and <a href="#commandFinished">commandFinished</a>().
|
|
|
|
<p>Example: <a href="ftpclient-example.html#x756">network/ftpclient/ftpmainwindow.ui.h</a>.
|
|
<h3 class=fn>void <a name="listInfo"></a>TQFtp::listInfo ( const <a href="qurlinfo.html">TQUrlInfo</a> & i )<tt> [signal]</tt>
|
|
</h3>
|
|
|
|
<p> This signal is emitted for each directory entry the <a href="#list">list</a>() command
|
|
finds. The details of the entry are stored in <em>i</em>.
|
|
<p> <p>See also <a href="#list">list</a>().
|
|
|
|
<p>Example: <a href="ftpclient-example.html#x757">network/ftpclient/ftpmainwindow.ui.h</a>.
|
|
<h3 class=fn>int <a name="login"></a>TQFtp::login ( const <a href="qstring.html">TQString</a> & user = TQString::null, const <a href="qstring.html">TQString</a> & password = TQString::null )
|
|
</h3>
|
|
Logs in to the FTP server with the username <em>user</em> and the
|
|
password <em>password</em>.
|
|
<p> The <a href="#stateChanged">stateChanged</a>() signal is emitted when the state of the
|
|
connecting process changes, e.g. to <a href="#State-enum">LoggedIn</a>.
|
|
<p> The function does not block and returns immediately. The command
|
|
is scheduled, and its execution is performed asynchronously. The
|
|
function returns a unique identifier which is passed by
|
|
<a href="#commandStarted">commandStarted</a>() and <a href="#commandFinished">commandFinished</a>().
|
|
<p> When the command is started the commandStarted() signal is
|
|
emitted. When it is finished the commandFinished() signal is
|
|
emitted.
|
|
<p> <p>See also <a href="#commandStarted">commandStarted</a>() and <a href="#commandFinished">commandFinished</a>().
|
|
|
|
<p>Example: <a href="ftpclient-example.html#x758">network/ftpclient/ftpmainwindow.ui.h</a>.
|
|
<h3 class=fn>int <a name="mkdir"></a>TQFtp::mkdir ( const <a href="qstring.html">TQString</a> & dir )
|
|
</h3>
|
|
Creates a directory called <em>dir</em> on the server.
|
|
<p> The function does not block and returns immediately. The command
|
|
is scheduled, and its execution is performed asynchronously. The
|
|
function returns a unique identifier which is passed by
|
|
<a href="#commandStarted">commandStarted</a>() and <a href="#commandFinished">commandFinished</a>().
|
|
<p> When the command is started the commandStarted() signal is
|
|
emitted. When it is finished the commandFinished() signal is
|
|
emitted.
|
|
<p> <p>See also <a href="#commandStarted">commandStarted</a>() and <a href="#commandFinished">commandFinished</a>().
|
|
|
|
<h3 class=fn>int <a name="put"></a>TQFtp::put ( <a href="qiodevice.html">TQIODevice</a> * dev, const <a href="qstring.html">TQString</a> & file )
|
|
</h3>
|
|
Reads the data from the IO device <em>dev</em>, and writes it to the
|
|
file called <em>file</em> on the server. The data is read in chunks from
|
|
the IO device, so this overload allows you to transmit large
|
|
amounts of data without the need to read all the data into memory
|
|
at once.
|
|
<p> Make sure that the <em>dev</em> pointer is valid for the duration of the
|
|
operation (it is safe to delete it when the <a href="#commandFinished">commandFinished</a>() is
|
|
emitted).
|
|
|
|
<p>Example: <a href="ftpclient-example.html#x759">network/ftpclient/ftpmainwindow.ui.h</a>.
|
|
<h3 class=fn>int <a name="put-2"></a>TQFtp::put ( const <a href="qbytearray.html">TQByteArray</a> & data, const <a href="qstring.html">TQString</a> & file )
|
|
</h3>
|
|
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
|
<p> Writes the data <em>data</em> to the file called <em>file</em> on the server.
|
|
The progress of the upload is reported by the
|
|
<a href="#dataTransferProgress">dataTransferProgress</a>() signal.
|
|
<p> The function does not block and returns immediately. The command
|
|
is scheduled, and its execution is performed asynchronously. The
|
|
function returns a unique identifier which is passed by
|
|
<a href="#commandStarted">commandStarted</a>() and <a href="#commandFinished">commandFinished</a>().
|
|
<p> When the command is started the commandStarted() signal is
|
|
emitted. When it is finished the commandFinished() signal is
|
|
emitted.
|
|
<p> <p>See also <a href="#dataTransferProgress">dataTransferProgress</a>(), <a href="#commandStarted">commandStarted</a>(), and <a href="#commandFinished">commandFinished</a>().
|
|
|
|
<h3 class=fn>int <a name="rawCommand"></a>TQFtp::rawCommand ( const <a href="qstring.html">TQString</a> & command )
|
|
</h3>
|
|
Sends the raw FTP command <em>command</em> to the FTP server. This is
|
|
useful for low-level FTP access. If the operation you wish to
|
|
perform has an equivalent TQFtp function, we recommend using the
|
|
function instead of raw FTP commands since the functions are
|
|
easier and safer.
|
|
<p> The function does not block and returns immediately. The command
|
|
is scheduled, and its execution is performed asynchronously. The
|
|
function returns a unique identifier which is passed by
|
|
<a href="#commandStarted">commandStarted</a>() and <a href="#commandFinished">commandFinished</a>().
|
|
<p> When the command is started the commandStarted() signal is
|
|
emitted. When it is finished the commandFinished() signal is
|
|
emitted.
|
|
<p> <p>See also <a href="#rawCommandReply">rawCommandReply</a>(), <a href="#commandStarted">commandStarted</a>(), and <a href="#commandFinished">commandFinished</a>().
|
|
|
|
<p>Example: <a href="ftpclient-example.html#x760">network/ftpclient/ftpmainwindow.ui.h</a>.
|
|
<h3 class=fn>void <a name="rawCommandReply"></a>TQFtp::rawCommandReply ( int replyCode, const <a href="qstring.html">TQString</a> & detail )<tt> [signal]</tt>
|
|
</h3>
|
|
|
|
<p> This signal is emitted in response to the <a href="#rawCommand">rawCommand</a>() function.
|
|
<em>replyCode</em> is the 3 digit reply code and <em>detail</em> is the text
|
|
that follows the reply code.
|
|
<p> <p>See also <a href="#rawCommand">rawCommand</a>().
|
|
|
|
<p>Example: <a href="ftpclient-example.html#x761">network/ftpclient/ftpmainwindow.ui.h</a>.
|
|
<h3 class=fn><a href="qbytearray.html">TQByteArray</a> <a name="readAll"></a>TQFtp::readAll ()
|
|
</h3>
|
|
Reads all the bytes available from the data socket and returns
|
|
them.
|
|
<p> <p>See also <a href="#get">get</a>(), <a href="#readyRead">readyRead</a>(), <a href="#bytesAvailable">bytesAvailable</a>(), and <a href="#readBlock">readBlock</a>().
|
|
|
|
<h3 class=fn>Q_LONG <a name="readBlock"></a>TQFtp::readBlock ( char * data, Q_ULONG maxlen )
|
|
</h3>
|
|
Reads <em>maxlen</em> bytes from the data socket into <em>data</em> and
|
|
returns the number of bytes read. Returns -1 if an error occurred.
|
|
<p> <p>See also <a href="#get">get</a>(), <a href="#readyRead">readyRead</a>(), <a href="#bytesAvailable">bytesAvailable</a>(), and <a href="#readAll">readAll</a>().
|
|
|
|
<h3 class=fn>void <a name="readyRead"></a>TQFtp::readyRead ()<tt> [signal]</tt>
|
|
</h3>
|
|
|
|
<p> This signal is emitted in response to a <a href="#get">get</a>() command when there
|
|
is new data to read.
|
|
<p> If you specify a device as the second argument in the get()
|
|
command, this signal is <em>not</em> emitted; instead the data is
|
|
written directly to the device.
|
|
<p> You can read the data with the <a href="#readAll">readAll</a>() or <a href="#readBlock">readBlock</a>() functions.
|
|
<p> This signal is useful if you want to process the data in chunks as
|
|
soon as it becomes available. If you are only interested in the
|
|
complete data, just connect to the <a href="#commandFinished">commandFinished</a>() signal and
|
|
read the data then instead.
|
|
<p> <p>See also <a href="#get">get</a>(), <a href="#readBlock">readBlock</a>(), <a href="#readAll">readAll</a>(), and <a href="#bytesAvailable">bytesAvailable</a>().
|
|
|
|
<h3 class=fn>int <a name="remove"></a>TQFtp::remove ( const <a href="qstring.html">TQString</a> & file )
|
|
</h3>
|
|
Deletes the file called <em>file</em> from the server.
|
|
<p> The function does not block and returns immediately. The command
|
|
is scheduled, and its execution is performed asynchronously. The
|
|
function returns a unique identifier which is passed by
|
|
<a href="#commandStarted">commandStarted</a>() and <a href="#commandFinished">commandFinished</a>().
|
|
<p> When the command is started the commandStarted() signal is
|
|
emitted. When it is finished the commandFinished() signal is
|
|
emitted.
|
|
<p> <p>See also <a href="#commandStarted">commandStarted</a>() and <a href="#commandFinished">commandFinished</a>().
|
|
|
|
<p>Example: <a href="ftpclient-example.html#x762">network/ftpclient/ftpmainwindow.ui.h</a>.
|
|
<h3 class=fn>int <a name="rename"></a>TQFtp::rename ( const <a href="qstring.html">TQString</a> & oldname, const <a href="qstring.html">TQString</a> & newname )
|
|
</h3>
|
|
Renames the file called <em>oldname</em> to <em>newname</em> on the server.
|
|
<p> The function does not block and returns immediately. The command
|
|
is scheduled, and its execution is performed asynchronously. The
|
|
function returns a unique identifier which is passed by
|
|
<a href="#commandStarted">commandStarted</a>() and <a href="#commandFinished">commandFinished</a>().
|
|
<p> When the command is started the commandStarted() signal is
|
|
emitted. When it is finished the commandFinished() signal is
|
|
emitted.
|
|
<p> <p>See also <a href="#commandStarted">commandStarted</a>() and <a href="#commandFinished">commandFinished</a>().
|
|
|
|
<h3 class=fn>int <a name="rmdir"></a>TQFtp::rmdir ( const <a href="qstring.html">TQString</a> & dir )
|
|
</h3>
|
|
Removes the directory called <em>dir</em> from the server.
|
|
<p> The function does not block and returns immediately. The command
|
|
is scheduled, and its execution is performed asynchronously. The
|
|
function returns a unique identifier which is passed by
|
|
<a href="#commandStarted">commandStarted</a>() and <a href="#commandFinished">commandFinished</a>().
|
|
<p> When the command is started the commandStarted() signal is
|
|
emitted. When it is finished the commandFinished() signal is
|
|
emitted.
|
|
<p> <p>See also <a href="#commandStarted">commandStarted</a>() and <a href="#commandFinished">commandFinished</a>().
|
|
|
|
<h3 class=fn><a href="qftp.html#State-enum">State</a> <a name="state"></a>TQFtp::state () const
|
|
</h3>
|
|
Returns the current state of the object. When the state changes,
|
|
the <a href="#stateChanged">stateChanged</a>() signal is emitted.
|
|
<p> <p>See also <a href="#State-enum">State</a> and <a href="#stateChanged">stateChanged</a>().
|
|
|
|
<p>Example: <a href="ftpclient-example.html#x763">network/ftpclient/ftpmainwindow.ui.h</a>.
|
|
<h3 class=fn>void <a name="stateChanged"></a>TQFtp::stateChanged ( int state )<tt> [signal]</tt>
|
|
</h3>
|
|
|
|
<p> This signal is emitted when the state of the connection changes.
|
|
The argument <em>state</em> is the new state of the connection; it is
|
|
one of the <a href="#State-enum">State</a> values.
|
|
<p> It is usually emitted in response to a <a href="#connectToHost">connectToHost</a>() or <a href="#close">close</a>()
|
|
command, but it can also be emitted "spontaneously", e.g. when the
|
|
server closes the connection unexpectedly.
|
|
<p> <p>See also <a href="#connectToHost">connectToHost</a>(), <a href="#close">close</a>(), <a href="#state">state</a>(), and <a href="#State-enum">State</a>.
|
|
|
|
<p>Example: <a href="ftpclient-example.html#x764">network/ftpclient/ftpmainwindow.ui.h</a>.
|
|
<!-- eof -->
|
|
<hr><p>
|
|
This file is part of the <a href="index.html">TQt toolkit</a>.
|
|
Copyright © 1995-2007
|
|
<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
|
|
<table width=100% cellspacing=0 border=0><tr>
|
|
<td>Copyright © 2007
|
|
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
|
<td align=right><div align=right>TQt 3.3.8</div>
|
|
</table></div></address></body>
|
|
</html>
|