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 のデータグラムを、ポートport のホストアドレスaddress に送信する。成功すれば送信バイト数を返し、そうでなければ -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 を返します。