?? qsocket.html
字號(hào):
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/reggie/tmp/qt-3.0-reggie-5401/qt-x11-commercial-3.0.5/src/network/qsocket.cpp:113 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
<meta name="Translator" content="Cavendish">
<meta name="Qt zh_CN Documents Website" content="http://www.qiliang.net/qt">
<title>QSocket類</title>
<style type="text/css"><!--
h3.fn,span.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; font-family: "Times New Roman" }
--></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">主頁</font></a>
| <a href="classes.html">
<font color="#004faf">所有的類</font></a>
| <a href="mainclasses.html">
<font color="#004faf">主要的類</font></a>
| <a href="annotated.html">
<font color="#004faf">注釋的類</font></a>
| <a href="groups.html">
<font color="#004faf">分組的類</font></a>
| <a href="functions.html">
<font color="#004faf">函數(shù)</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>QSocket類參考<br><small>[<a href="network.html">網(wǎng)絡(luò)模塊</a>]</small></h1>
<p>QSocket類提供了一個(gè)有緩沖的TCP連接。
<a href="#details">詳情請(qǐng)見……</a>
<p><tt>#include <<a href="qsocket-h.html">qsocket.h</a>></tt>
<p>繼承了<a href="qobject.html">QObject</a>和<a href="qiodevice.html">QIODevice</a>。
<p><a href="qsocket-members.html">所有成員函數(shù)的列表。</a>
<h2>公有成員</h2>
<ul>
<li><div class=fn>enum <a href="#Error-enum"><b>Error</b></a> { ErrConnectionRefused, ErrHostNotFound, ErrSocketRead }</div></li>
<li><div class=fn><a href="#QSocket"><b>QSocket</b></a> ( QObject * parent = 0, const char * name = 0 )</div></li>
<li><div class=fn>virtual <a href="#~QSocket"><b>~QSocket</b></a> ()</div></li>
<li><div class=fn>enum <a href="#State-enum"><b>State</b></a> { Idle, HostLookup, Connecting, Connected, Closing, Connection = Connected }</div></li>
<li><div class=fn>int <a href="#socket"><b>socket</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#setSocket"><b>setSocket</b></a> ( int socket )</div></li>
<li><div class=fn>QSocketDevice * <a href="#socketDevice"><b>socketDevice</b></a> ()</div></li>
<li><div class=fn>virtual void <a href="#setSocketDevice"><b>setSocketDevice</b></a> ( QSocketDevice * device )</div></li>
<li><div class=fn>virtual void <a href="#connectToHost"><b>connectToHost</b></a> ( const QString & host, Q_UINT16 port )</div></li>
<li><div class=fn>QString <a href="#peerName"><b>peerName</b></a> () const</div></li>
<li><div class=fn>virtual bool <a href="#open"><b>open</b></a> ( int m )</div></li>
<li><div class=fn>virtual void <a href="#close"><b>close</b></a> ()</div></li>
<li><div class=fn>virtual void <a href="#flush"><b>flush</b></a> ()</div></li>
<li><div class=fn>virtual Offset <a href="#size"><b>size</b></a> () const</div></li>
<li><div class=fn>virtual Offset <a href="#at"><b>at</b></a> () const</div></li>
<li><div class=fn>virtual bool <a href="#at-2"><b>at</b></a> ( Offset index )</div></li>
<li><div class=fn>virtual bool <a href="#atEnd"><b>atEnd</b></a> () const</div></li>
<li><div class=fn>Q_ULONG <a href="#bytesAvailable"><b>bytesAvailable</b></a> () const</div></li>
<li><div class=fn>Q_ULONG <a href="#waitForMore"><b>waitForMore</b></a> ( int msecs ) const</div></li>
<li><div class=fn>Q_ULONG <a href="#bytesToWrite"><b>bytesToWrite</b></a> () const</div></li>
<li><div class=fn>virtual Q_LONG <a href="#readBlock"><b>readBlock</b></a> ( char * data, Q_ULONG maxlen )</div></li>
<li><div class=fn>virtual Q_LONG <a href="#writeBlock"><b>writeBlock</b></a> ( const char * data, Q_ULONG len )</div></li>
<li><div class=fn>virtual int <a href="#getch"><b>getch</b></a> ()</div></li>
<li><div class=fn>virtual int <a href="#putch"><b>putch</b></a> ( int ch )</div></li>
<li><div class=fn>virtual int <a href="#ungetch"><b>ungetch</b></a> ( int ch )</div></li>
<li><div class=fn>bool <a href="#canReadLine"><b>canReadLine</b></a> () const</div></li>
<li><div class=fn>virtual QString <a href="#readLine"><b>readLine</b></a> ()</div></li>
<li><div class=fn>Q_UINT16 <a href="#port"><b>port</b></a> () const</div></li>
<li><div class=fn>Q_UINT16 <a href="#peerPort"><b>peerPort</b></a> () const</div></li>
<li><div class=fn>QHostAddress <a href="#address"><b>address</b></a> () const</div></li>
<li><div class=fn>QHostAddress <a href="#peerAddress"><b>peerAddress</b></a> () const</div></li>
</ul>
<h2>信號(hào)</h2>
<ul>
<li><div class=fn>void <a href="#hostFound"><b>hostFound</b></a> ()</div></li>
<li><div class=fn>void <a href="#connected"><b>connected</b></a> ()</div></li>
<li><div class=fn>void <a href="#connectionClosed"><b>connectionClosed</b></a> ()</div></li>
<li><div class=fn>void <a href="#delayedCloseFinished"><b>delayedCloseFinished</b></a> ()</div></li>
<li><div class=fn>void <a href="#readyRead"><b>readyRead</b></a> ()</div></li>
<li><div class=fn>void <a href="#bytesWritten"><b>bytesWritten</b></a> ( int nbytes )</div></li>
<li><div class=fn>void <a href="#error"><b>error</b></a> ( int )</div></li>
</ul>
<h2>保護(hù)槽</h2>
<ul>
<li><div class=fn>virtual void <a href="#sn_read"><b>sn_read</b></a> ( bool force = FALSE )</div></li>
<li><div class=fn>virtual void <a href="#sn_write"><b>sn_write</b></a> ()</div></li>
</ul>
<hr><a name="details"></a><h2>詳細(xì)描述</h2>
QSocket類提供了一個(gè)有緩沖的TCP連接。
<p>
<p> 它提供一個(gè)完全非阻塞的<a href="qiodevice.html">QIODevice</a>，使用套接字特征代碼來修改和擴(kuò)展了QIODevice的應(yīng)用編程接口。
<p> 你和可能常常調(diào)用的<a href="#connectToHost">connectToHost</a>()、<a href="#bytesAvailable">bytesAvailable</a>()、<a href="#canReadLine">canReadLine</a>()這些函數(shù)并且它們繼承了QIODevice。
<p> connectToHost()是一個(gè)最常用的函數(shù)。就像它的名字那樣，它打開一個(gè)被命名的主機(jī)的連接。
<p> 絕大多數(shù)網(wǎng)絡(luò)協(xié)議是基于包的或者基于行的。canReadLine()可以識(shí)別一個(gè)連接中是否包含一個(gè)完全不可讀的的行，并且bytesAvailable()返回可以被讀取的字節(jié)數(shù)量。
<p> 信號(hào)<a href="#error">error</a>()、<a href="#connected">connected</a>()、<a href="#readyRead">readyRead</a>()和<a href="#connectionClosed">connectionClosed</a>()通知你連接的進(jìn)展。還有一些不太常用的信號(hào)。當(dāng)connectToHost()已經(jīng)完成它的DNS查找并且正在開始它的TCP連接時(shí)，<a href="#hostFound">hostFound</a>()被發(fā)射。當(dāng)<a href="#close">close</a>()成功時(shí)，<a href="#delayedCloseFinished">delayedCloseFinished</a>()被發(fā)射。當(dāng)QSocket把它的“寫”隊(duì)列中的數(shù)據(jù)移到TCP運(yùn)行中。
<p> 還有幾個(gè)套接字的訪問函數(shù)：<a href="#state">state</a>()返回這個(gè)對(duì)象是否空閑，是否正在做DNS查找，是否正在連接，還是一個(gè)正在操作的連接，等等。<a href="#address">address</a>()和<a href="#port">port</a>()返回連接所使用的IP地址和端口。<a href="#peerAddress">peerAddress</a>()和<a href="#peerPort">peerPort</a>()函數(shù)返回自身所用到的IP地址和端口并且<a href="#peerName">peerName</a>()返回自身所用的名稱（通常是被傳送給<a href="#connectToHost">connectToHost</a>()的名字）。<a href="#socket">socket</a>() 返回這個(gè)套接字所用到的<a href="qsocketdevice.html">QSocketDevice</a>的指針。
<p> QSocket繼承了<a href="qiodevice.html">QIODevice</a>并且重新實(shí)現(xiàn)了一些函數(shù)。通常你可以把它作為QIODevice來寫，并且絕大多數(shù)情況也可以作為QIODevice來讀。但匹配的不夠完美，因?yàn)镼IODevice應(yīng)用編程接口是為同一個(gè)機(jī)器可以控制的設(shè)備而設(shè)計(jì)的，而異步的端對(duì)端網(wǎng)絡(luò)連接和這個(gè)不太一樣。例如，沒有什么可以和<a href="qiodevice.html#size">QIODevice::size</a>()確切地匹配。<a href="#open">open</a>()、<a href="#close">close</a>()、<a href="#flush">flush</a>()、<a href="#size">size</a>()、<a href="#at">at</a>()、<a href="#atEnd">atEnd</a>()、<a href="#readBlock">readBlock</a>()、<a href="#writeBlock">writeBlock</a>()、<a href="#getch">getch</a>()、<a href="#putch">putch</a>()、<a href="#ungetch">ungetch</a>()和<a href="#readLine">readLine</a>()的文檔詳細(xì)地描述了不同點(diǎn)。
<p> <p>也可以參考<a href="qsocketdevice.html">QSocketDevice</a>、<a href="qhostaddress.html">QHostAddress</a>、<a href="qsocketnotifier.html">QSocketNotifier</a>和<a href="io.html">輸入/輸出和網(wǎng)絡(luò)</a>。
<hr><h2>成員類型文檔</h2>
<h3 class=fn><a name="Error-enum"></a>QSocket::Error</h3>
<p> 這個(gè)枚舉變量指定了可能的錯(cuò)誤：
<ul>
<li><tt>QSocket::ErrConnectionRefused</tt> - 如果連接被拒絕
<li><tt>QSocket::ErrHostNotFound</tt> - 如果主機(jī)沒有被找到
<li><tt>QSocket::ErrSocketRead</tt> - 如果讀取套接字失敗
</ul>
<h3 class=fn><a name="State-enum"></a>QSocket::State</h3>
<p> 這個(gè)枚舉變量定義了連接狀態(tài)：
<ul>
<li><tt>QSocket::Idle</tt> - 如果沒有連接
<li><tt>QSocket::HostLookup</tt> - 在DNS查找期間
<li><tt>QSocket::Connecting</tt> - 在TCP連接建立期間
<li><tt>QSocket::Connected</tt> - 當(dāng)存在一個(gè)可操作的連接時(shí)
<li><tt>QSocket::Closing</tt> - 如果這個(gè)套接字正在關(guān)閉，但是還沒有被關(guān)閉。
</ul>
<hr><h2>成員函數(shù)文檔</h2>
<h3 class=fn><a name="QSocket"></a>QSocket::QSocket ( <a href="qobject.html">QObject</a> * parent = 0, const char * name = 0 )
</h3>
創(chuàng)建一個(gè)<a href="#State-enum">QSocket::Idle</a>狀態(tài)的QSocket對(duì)象。
<p> <em>parent</em>和<em>name</em>參數(shù)被傳遞給<a href="qobject.html">QObject</a>的構(gòu)造函數(shù)。
<h3 class=fn><a name="~QSocket"></a>QSocket::~QSocket ()<tt> [虛]</tt>
</h3>
銷毀這個(gè)套接字。如果需要關(guān)閉連接。
<p>也可以參考<a href="#close">close</a>()。
<h3 class=fn><a href="qhostaddress.html">QHostAddress</a> <a name="address"></a>QSocket::address () const
</h3>
返回這個(gè)套接字的主機(jī)地址。（這通常就是主機(jī)的主IP地址，但是對(duì)于到localhost的連接可能是127.0.0.1。）
<h3 class=fn><a href="qiodevice.html#Offset">Offset</a> <a name="at"></a>QSocket::at () const<tt> [虛]</tt>
</h3>
返回當(dāng)前的讀索引。因?yàn)镼Socket是一個(gè)順序設(shè)備，當(dāng)前讀索引總是0。
<p>Reimplemented from <a href="qiodevice.html#at">QIODevice</a>.
<h3 class=fn>bool <a name="at-2"></a>QSocket::at ( <a href="qiodevice.html#Offset">Offset</a> index )<tt> [虛]</tt>
</h3>
這是一個(gè)重載成員函數(shù)，提供了方便。它的行為基本上和上面的函數(shù)相同。
<p> 向前移動(dòng)讀索引到<em>index</em>并且如果操作成功返回真。向前移動(dòng)讀索引意味著忽略進(jìn)入的數(shù)據(jù)。
<p>從<a href="qiodevice.html#at-2">QIODevice</a>中重新實(shí)現(xiàn)的。
<h3 class=fn>bool <a name="atEnd"></a>QSocket::atEnd () const<tt> [虛]</tt>
</h3>
如果沒有更多的數(shù)據(jù)可以讀取，返回真，否則返回假。
<p>從<a href="qiodevice.html#atEnd">QIODevice</a>中重新實(shí)現(xiàn)的。
<h3 class=fn>Q_ULONG <a name="bytesAvailable"></a>QSocket::bytesAvailable () const
</h3>
返回可以讀取的進(jìn)入數(shù)據(jù)的字節(jié)數(shù)，也就是輸入緩存的大小。等于<a href="#size">size</a>()。
<p> <p>也可以參考<a href="#bytesToWrite">bytesToWrite</a>()。
<p>實(shí)例：<a href="networkprotocol-example.html#x606">network/networkprotocol/nntp.cpp</a>。
<h3 class=fn>Q_ULONG <a name="bytesToWrite"></a>QSocket::bytesToWrite () const
</h3>
返回正在等待被寫的數(shù)據(jù)的字節(jié)數(shù)，也就是輸出緩存的大小。
<p> <p>也可以參考<a href="#bytesAvailable">bytesAvailable</a>()。
<h3 class=fn>void <a name="bytesWritten"></a>QSocket::bytesWritten ( int nbytes )<tt> [信號(hào)]</tt>
</h3>
<p> 當(dāng)數(shù)據(jù)被實(shí)際寫到網(wǎng)絡(luò)時(shí)，這個(gè)信號(hào)被發(fā)射。<em>nbytes</em>參數(shù)指定了多少字節(jié)被寫了。
<p> <a href="#bytesToWrite">bytesToWrite</a>()函數(shù)常常會(huì)在相同的上下文中被使用，并且它說明了還有多少數(shù)量的緩存字節(jié)數(shù)要寫。
<p> <p>也可以參考<a href="#writeBlock">writeBlock</a>()和<a href="#bytesToWrite">bytesToWrite</a>()。
<h3 class=fn>bool <a name="canReadLine"></a>QSocket::canReadLine () const
</h3>
如果這一次可以從這個(gè)套接字中讀取一個(gè)完整行的文本，返回真，否則返回假。
<p> 注意如果本地出乎意料地關(guān)閉連接，這個(gè)函數(shù)返回假。這也就是說這樣的循環(huán)不會(huì)工作：
<p> <pre>
while( !socket->canReadLine() ) // 錯(cuò)了。
...
</pre>
<p> <p>也可以參考<a href="#readLine">readLine</a>()。
<p>實(shí)例：<a href="clientserver-example.html#x780">network/clientserver/client/client.cpp</a>、<a href="httpd-example.html#x639">network/httpd/httpd.cpp</a>、<a href="mail-example.html#x755">network/mail/smtp.cpp</a>和<a href="networkprotocol-example.html#x607">network/networkprotocol/nntp.cpp</a>。
?? 快捷鍵說明
復(fù)制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號(hào)
Ctrl + =
減小字號(hào)
Ctrl + -