懂小姐 發表於 2026-1-4 10:02:20

Qt中QUdpSocket类的简单使用详解

<div id="navCategory"><h5 class="catalogue">目录</h5><ul class="first_class_ul"><li>QUdpSocket类的简单使用</li><ul class="second_class_ul"><li>一、发送端</li><li>二、接收端</li></ul></ul></div><p class="maodian"></p><h2>QUdpSocket类的简单使用</h2>
<p>下面我们用一个做一个简单的例子。</p>
<p class="maodian"></p><h3>一、发送端</h3>
<p>发送端界面:</p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202601/2026010410020797.png" /></p>
<p>发送端代码:</p>
<p>.h</p>
<div class="jb51code"><pre class="brush:cpp;">#ifndef MAINWINDOW_H
#define MAINWINDOW_H
#include &lt;QMainWindow&gt;
#include &lt;QUdpSocket&gt;
QT_BEGIN_NAMESPACE
namespace Ui {
class MainWindow;
}
QT_END_NAMESPACE
class MainWindow : public QMainWindow
{
    Q_OBJECT
public:
    MainWindow(QWidget *parent = nullptr);
    ~MainWindow();
private slots:
    void on_btnUnicast_clicked();
    void on_btnBoardcast_clicked();
private:
    Ui::MainWindow *ui;
    QUdpSocket* m_pSender = nullptr;
};
#endif // MAINWINDOW_H</pre></div>
<p>.cpp</p>
<div class="jb51code"><pre class="brush:cpp;">#include "mainwindow.h"
#include "ui_mainwindow.h"
#include &lt;QHostAddress&gt;
#include &lt;QDebug&gt;
MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui-&gt;setupUi(this);
    m_pSender = new QUdpSocket(this);
}
MainWindow::~MainWindow()
{
    delete ui;
    delete m_pSender;
}
void MainWindow::on_btnUnicast_clicked()
{
    QString strText = ui-&gt;lineEdit-&gt;text();
    if(strText.isEmpty())
      return;
    QHostAddress host("127.0.0.1");
    quint16 nPort = 8888;
    qint64 nSend = m_pSender-&gt;writeDatagram(strText.toUtf8(),host,nPort);
    if(nSend == -1)
    {
      qDebug() &lt;&lt; "单播发送失败" &lt;&lt; m_pSender-&gt;errorString();
    }
    else
    {
      qDebug() &lt;&lt; "单播发送成功,字节数" &lt;&lt; nSend;
    }
}
void MainWindow::on_btnBoardcast_clicked()
{
    QString strText = ui-&gt;lineEdit-&gt;text();
    if(strText.isEmpty())
      return;
    quint16 nPort = 8888;
    qint64 nSend = m_pSender-&gt;writeDatagram(strText.toUtf8(),QHostAddress::Broadcast,nPort);
    if(nSend == -1)
    {
      qDebug() &lt;&lt; "广播发送失败" &lt;&lt; m_pSender-&gt;errorString();
    }
    else
    {
      qDebug() &lt;&lt; "广播发送成功,字节数" &lt;&lt; nSend;
    }
}</pre></div>
<p class="maodian"></p><h3>二、接收端</h3>
<p>接受端的界面,比较简单:</p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202601/2026010410020833.png" /></p>
<p>接受端代码如下:</p>
<p>.h</p>
<div class="jb51code"><pre class="brush:cpp;">#ifndef MAINWINDOW_H
#define MAINWINDOW_H
#include &lt;QMainWindow&gt;
#include &lt;QUdpSocket&gt;
QT_BEGIN_NAMESPACE
namespace Ui {
class MainWindow;
}
QT_END_NAMESPACE
class MainWindow : public QMainWindow
{
    Q_OBJECT
public:
    MainWindow(QWidget *parent = nullptr);
    ~MainWindow();
public slots:
    void ReadDatagram();
private:
    Ui::MainWindow *ui;
    QUdpSocket* m_pReceiver;
};
#endif // MAINWINDOW_H</pre></div>
<p>.cpp</p>
<div class="jb51code"><pre class="brush:cpp;">#include "mainwindow.h"
#include "ui_mainwindow.h"
MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui-&gt;setupUi(this);
    m_pReceiver = new QUdpSocket(this);
    quint16 listenPort = 8888;
    // 绑定端口:QHostAddress::Any 表示监听所有网卡的该端口(支持本机/局域网/外网)
    bool bBind = m_pReceiver-&gt;bind(QHostAddress::Any,listenPort);
    if(!bBind)
    {
      ui-&gt;textEdit-&gt;append("绑定端口失败:" + m_pReceiver-&gt;errorString());
    }
    else
    {
      ui-&gt;textEdit-&gt;append("已绑定端口 " + QString::number(listenPort) + ",等待接收数据...");
    }
    // 绑定接收数据信号:当有数据到达时触发readyRead()
    connect(m_pReceiver,&amp;QUdpSocket::readyRead,this,&amp;MainWindow::ReadDatagram);
}
MainWindow::~MainWindow()
{
    delete ui;
    delete m_pReceiver;
}
void MainWindow::ReadDatagram()
{
    // 循环读取所有待处理的数据包(可能同时有多个)
    while (m_pReceiver-&gt;hasPendingDatagrams())
    {
      QByteArray datagram;
      // 预留足够的缓冲区(根据数据包大小调整,这里设为1024)
      datagram.resize(m_pReceiver-&gt;pendingDatagramSize());
      QHostAddress senderIp; // 发送方IP
      quint16 senderPort;    // 发送方端口
      // 读取数据包,同时获取发送方的IP和端口
      qint64 readBytes = m_pReceiver-&gt;readDatagram(
            datagram.data(),
            datagram.size(),
            &amp;senderIp,
            &amp;senderPort
            );
      if (readBytes == -1)
      {
            ui-&gt;textEdit-&gt;append("接收失败:" + m_pReceiver-&gt;errorString());
            continue;
      }
      // 解析并显示数据
      QString recvData = QString::fromUtf8(datagram);
      QString log = QString("[%1:%2] 接收数据:%3")
                        .arg(senderIp.toString())
                        .arg(senderPort)
                        .arg(recvData);
      ui-&gt;textEdit-&gt;append(log);
    }
}</pre></div>
<p>代码说明:</p>
<ol><li>核心类<code>QUdpSocket</code>:
<ul><li>发送:<code>writeDatagram()</code> 直接发送数据包,无需建立连接,这是 UDP &ldquo;无连接&rdquo; 的核心体现;</li><li>接收:绑定端口后,通过<code>readyRead()</code>信号监听数据,<code>readDatagram()</code>读取数据并获取发送方信息;</li><li>广播:<code>QHostAddress::Broadcast</code> 是 UDP 独有的能力,TCP 无法实现。</li></ul></li><li><strong>绑定端口的参数</strong>:<ul><li><code>QHostAddress::Any</code>:监听所有网卡的指定端口,支持接收来自本机、局域网其他设备的 UDP 数据;</li><li>若仅监听本机,可用<code>QHostAddress::LocalHost</code>(127.0.0.1)。</li></ul></li><li><strong>数据编码</strong>:<ul><li>用<code>toUtf8()</code>/<code>fromUtf8()</code>转换<code>QString</code>和<code>QByteArray</code>,保证跨平台编码一致性,避免中文乱码。</li></ul></li><li><strong>对比 TCP 的简化点</strong>:<ul><li>UDP 无需调用<code>connectToHost()</code>建立连接,也无需处理<code>connected()</code>/<code>disconnected()</code>信号;</li><li>无需处理粘包:<code>pendingDatagramSize()</code>可获取单个数据包的大小,一次读取即可,而 TCP 需自定义协议拆包。</li></ul></li></ol>
<p>项目运行结果:</p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202601/2026010410020818.gif" /></p>
<p>到此这篇关于Qt中QUdpSocket类的简单使用的文章就介绍到这了,更多相关Qt QUdpSocket类使用内容请搜索琼殿技术社区以前的文章或继续浏览下面的相关文章希望大家以后多多支持琼殿技术社区!</p>
                           
                            <div class="art_xg">
                              <b>您可能感兴趣的文章:</b><ul><li>C++ Qt开发之使用QUdpSocket实现组播通信</li><li>C++ Qt开发之使用QUdpSocket实现UDP网络通信</li><li>Qt&nbsp;UDP&nbsp;Socket的具体使用</li></ul>
                            </div>

                        </div>
                        <!--endmain-->
頁: [1]
查看完整版本: Qt中QUdpSocket类的简单使用详解