QUdpSocket Class

void Server::initSocket()
{
    udpSocket = new QUdpSocket(this);
    udpSocket->bind(QHostAddress::LocalHost, 7755);

    connect(udpSocket, &QUdpSocket::readyRead,
            this, &Server::readPendingDatagrams);
}

void Server::readPendingDatagrams()
{
    while (udpSocket->hasPendingDatagrams()) {
        QNetworkDatagram datagram = udpSocket->receiveDatagram();
        processTheDatagram(datagram);
    }
}

メンバ関数のドキュメント

[explicit] QUdpSocket::QUdpSocket(QObject *parent = nullptr)

QUdpSocket オブジェクトを作成します。

parent QObject のコンストラクタに渡されます。

socketType()も参照してください 。

[virtual noexcept] QUdpSocket::~QUdpSocket()

ソケットを破棄し、必要に応じて接続を閉じます。

close()も参照してください 。

bool QUdpSocket::hasPendingDatagrams() const

読み取り待ちのデータグラムが少なくとも1つある場合はtrue を返し、そうでない場合はfalse を返します。

pendingDatagramSize() およびreadDatagram()も参照してください 。

bool QUdpSocket::joinMulticastGroup(const QHostAddress &groupAddress)

オペレーティングシステムによって選択されたデフォルトのインターフェース上で、groupAddress で指定されたマルチキャストグループに参加します。ソケットは BoundState である必要があります。そうでない場合、エラーが発生します。

IPv4グループに参加しようとする場合、ソケットはIPv6（またはデュアルモードでQHostAddress::Any を使用）でバインドされていてはならないことに注意してください。代わりにQHostAddress::AnyIPv4 を使用する必要があります。

この関数は、成功した場合は `true ` を返します。失敗した場合は `false ` を返し、ソケットのエラーを適切に設定します。

関連項目 :leaveMulticastGroup()

bool QUdpSocket::joinMulticastGroup(const QHostAddress &groupAddress, const QNetworkInterface &iface)

インターフェースiface 上で、マルチキャストグループアドレスgroupAddress に参加します。

leaveMulticastGroup()も参照してください 。

bool QUdpSocket::leaveMulticastGroup(const QHostAddress &groupAddress)

オペレーティングシステムによって選択されたデフォルトのインターフェース上で、groupAddress で指定されたマルチキャストグループから離脱します。ソケットは BoundState である必要があります。そうでない場合、エラーが発生します。

この関数は、成功した場合に `true ` を返します。失敗した場合は `false ` を返し、ソケットのエラー状態を適切に設定します。

joinMulticastGroup()も参照してください 。

bool QUdpSocket::leaveMulticastGroup(const QHostAddress &groupAddress, const QNetworkInterface &iface)

インターフェースiface 上で、groupAddress で指定されたマルチキャストグループから退出します。

joinMulticastGroup()も参照してください 。

QNetworkInterface QUdpSocket::multicastInterface() const

マルチキャストデータグラムの送信インターフェースを返します。 これは、IPv4ソケットの `IP_MULTICAST_IF` ソケットオプションおよびIPv6ソケットの `IPV6_MULTICAST_IF` ソケットオプションに対応します。事前にインターフェースが設定されていない場合、この関数は無効な `QNetworkInterface` を返します。ソケットは `BoundState` 状態である必要があります。そうでない場合、無効な `QNetworkInterface ` が返されます。

setMulticastInterface()も参照してください 。

qint64 QUdpSocket::pendingDatagramSize() const

最初の保留中のUDPデータグラムのサイズを返します。利用可能なデータグラムがない場合、この関数は-1を返します。

hasPendingDatagrams() およびreadDatagram()も参照してください 。

qint64 QUdpSocket::readDatagram(char *data, qint64 maxSize, QHostAddress *address = nullptr, quint16 *port = nullptr)

maxSize バイト以下のデータグラムを受信し、それをdata に格納します。送信元のホストアドレスとポートは、*address および*port に格納されます（ただし、これらのポインタがnullptr である場合は除きます）。

成功した場合はデータグラムのサイズを返し、失敗した場合は -1 を返します。

maxSize が小さすぎる場合、データグラムの残りの部分は失われます。データの損失を防ぐには、読み取りを試みる前にpendingDatagramSize()を呼び出して、待機中のデータグラムのサイズを確認してください。maxSize が0の場合、データグラムは破棄されます。

writeDatagram()、hasPendingDatagrams()、およびpendingDatagramSize()も参照してください 。

QNetworkDatagram QUdpSocket::receiveDatagram(qint64 maxSize = -1)

maxSize バイト以下のデータグラムを受信し、送信元のホストアドレスおよびポートとともに、QNetworkDatagram オブジェクトとして返します。可能であれば、この関数は受信時にデータグラムの宛先アドレス、ポート、およびホップ数を特定しようとします。

失敗した場合は、not valid を報告するQNetworkDatagram を返します。

maxSize が小さすぎる場合、データグラムの残りの部分は失われます。maxSize が0の場合、データグラムは破棄されます。maxSize が-1（デフォルト）の場合、この関数はデータグラム全体を読み込もうとします。

writeDatagram()、hasPendingDatagrams()、およびpendingDatagramSize()も参照してください 。

void QUdpSocket::setMulticastInterface(const QNetworkInterface &iface)

マルチキャストデータグラムの送信インターフェースを、インターフェースiface に設定します。これは、IPv4 ソケットの IP_MULTICAST_IF ソケットオプション、および IPv6 ソケットの IPV6_MULTICAST_IF ソケットオプションに相当します。ソケットは BoundState である必要があります。そうでない場合、この関数は何も行いません。

multicastInterface()、joinMulticastGroup()、およびleaveMulticastGroup()も参照してください 。

qint64 QUdpSocket::writeDatagram(const char *data, qint64 size, const QHostAddress &address, quint16 port)

サイズがsize のデータグラムを、data からホストアドレスaddress のポートport へ送信します。成功した場合は送信されたバイト数を返し、失敗した場合は-1を返します。

データグラムは常に1つのブロックとして書き込まれます。データグラムの最大サイズはプラットフォームに大きく依存しますが、8192バイト程度まで小さくなる場合があります。データグラムが大きすぎる場合、この関数は-1を返し、error()はDatagramTooLargeErrorを返します。

512 バイトを超えるデータグラムの送信は、一般的に推奨されません。たとえ送信に成功したとしても、最終的な宛先に到達する前に IP 層によってフラグメント化される可能性が高いからです。

readDatagram() およびwrite()も参照してください 。

qint64 QUdpSocket::writeDatagram(const QNetworkDatagram &datagram)

datagram datagram に含まれるホストアドレスおよびポート番号宛てに、同ファイルに設定されたネットワークインターフェースおよびホップ数制限を使用して、データグラムを送信します。宛先アドレスおよびポート番号が設定されていない場合、この関数は () に渡されたアドレス宛てに送信を行います。connectToHost

宛先アドレスが IPv6 で、scope id が空でないものの、datagram に指定されたインターフェースインデックスと異なる場合、オペレーティングシステムがどのインターフェースを選択して送信するかは未定義です。

この関数は、成功した場合は送信されたバイト数を返し、エラーが発生した場合は -1 を返します。

QNetworkDatagram::setDestination()、QNetworkDatagram::setHopLimit()、およびQNetworkDatagram::setInterfaceIndex()も参照してください 。

qint64 QUdpSocket::writeDatagram(const QByteArray &datagram, const QHostAddress &host, quint16 port)

データグラムdatagram を、ホストアドレスhost のポートport へ送信します。

この関数は、成功した場合は送信されたバイト数を返し、エラーが発生した場合は -1 を返します。