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)

これはオーバーロードされた関数である。

groupAddress で指定されたマルチキャストグループをインターフェースiface に残す。

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 を返します。