 |
Qt 4.8
|
|
Qt 4.8
|
The QUdpSocket class provides a UDP socket. More...
#include <qudpsocket.h>
Public Functions | |
| bool | bind (const QHostAddress &address, quint16 port) |
| Binds this socket to the address address and the port port. More... | |
| bool | bind (quint16 port=0) |
| Binds to QHostAddress:Any on port port. More... | |
| bool | bind (const QHostAddress &address, quint16 port, BindMode mode) |
| Binds to address on port port, using the BindMode mode. More... | |
| bool | bind (quint16 port, BindMode mode) |
| Binds to QHostAddress:Any on port port, using the BindMode mode. More... | |
| bool | hasPendingDatagrams () const |
| Returns true if at least one datagram is waiting to be read; otherwise returns false. More... | |
| bool | joinMulticastGroup (const QHostAddress &groupAddress) |
| Joins the the multicast group specified by groupAddress on the default interface chosen by the operating system. More... | |
| bool | joinMulticastGroup (const QHostAddress &groupAddress, const QNetworkInterface &iface) |
| Joins the multicast group address groupAddress on the interface iface. More... | |
| bool | leaveMulticastGroup (const QHostAddress &groupAddress) |
| Leaves the multicast group specified by groupAddress on the default interface chosen by the operating system. More... | |
| bool | leaveMulticastGroup (const QHostAddress &groupAddress, const QNetworkInterface &iface) |
| Leaves the multicast group specified by groupAddress on the interface iface. More... | |
| QNetworkInterface | multicastInterface () const |
| Returns the interface for the outgoing interface for multicast datagrams. More... | |
| qint64 | pendingDatagramSize () const |
| Returns the size of the first pending UDP datagram. More... | |
| QUdpSocket (QObject *parent=0) | |
| Creates a QUdpSocket object. More... | |
| qint64 | readDatagram (char *data, qint64 maxlen, QHostAddress *host=0, quint16 *port=0) |
| Receives a datagram no larger than maxSize bytes and stores it in data. More... | |
| void | setMulticastInterface (const QNetworkInterface &iface) |
| Sets the outgoing interface for multicast datagrams to the interface iface. More... | |
| qint64 | writeDatagram (const char *data, qint64 len, const QHostAddress &host, quint16 port) |
| Sends the datagram at data of size size to the host address address at port port. More... | |
| qint64 | writeDatagram (const QByteArray &datagram, const QHostAddress &host, quint16 port) |
| Sends the datagram datagram to the host address host and at port port. More... | |
| virtual | ~QUdpSocket () |
| Destroys the socket, closing the connection if necessary. More... | |
 Public Functions inherited from QAbstractSocket | |
| void | abort () |
| Aborts the current connection and resets the socket. More... | |
| bool | atEnd () const |
| Returns true if no more data is currently available for reading; otherwise returns false. More... | |
| qint64 | bytesAvailable () const |
| Returns the number of incoming bytes that are waiting to be read. More... | |
| qint64 | bytesToWrite () const |
| Returns the number of bytes that are waiting to be written. More... | |
| bool | canReadLine () const |
| Returns true if a line of data can be read from the socket; otherwise returns false. More... | |
| void | close () |
| Closes the I/O device for the socket, disconnects the socket's connection with the host, closes the socket, and resets the name, address, port number and underlying socket descriptor. More... | |
| void | connectToHost (const QString &hostName, quint16 port, OpenMode mode=ReadWrite) |
| Attempts to make a connection to hostName on the given port. More... | |
| void | connectToHost (const QHostAddress &address, quint16 port, OpenMode mode=ReadWrite) |
| Attempts to make a connection to address on port port. More... | |
| void | disconnectFromHost () |
| Attempts to close the socket. More... | |
| SocketError | error () const |
| Returns the type of error that last occurred. More... | |
| bool | flush () |
| This function writes as much as possible from the internal write buffer to the underlying network socket, without blocking. More... | |
| bool | isSequential () const |
| Reimplemented Function More... | |
| bool | isValid () const |
| Returns true if the socket is valid and ready for use; otherwise returns false. More... | |
| QHostAddress | localAddress () const |
| Returns the host address of the local socket if available; otherwise returns QHostAddress::Null. More... | |
| quint16 | localPort () const |
| Returns the host port number (in native byte order) of the local socket if available; otherwise returns 0. More... | |
| QHostAddress | peerAddress () const |
| Returns the address of the connected peer if the socket is in ConnectedState; otherwise returns QHostAddress::Null. More... | |
| QString | peerName () const |
| Returns the name of the peer as specified by connectToHost(), or an empty QString if connectToHost() has not been called. More... | |
| quint16 | peerPort () const |
| Returns the port of the connected peer if the socket is in ConnectedState; otherwise returns 0. More... | |
| QNetworkProxy | proxy () const |
| Returns the network proxy for this socket. More... | |
| QAbstractSocket (SocketType socketType, QObject *parent) | |
| Creates a new abstract socket of type socketType. More... | |
| qint64 | readBufferSize () const |
| Returns the size of the internal read buffer. More... | |
| void | setProxy (const QNetworkProxy &networkProxy) |
| Sets the explicit network proxy for this socket to networkProxy. More... | |
| void | setReadBufferSize (qint64 size) |
| Sets the size of QAbstractSocket's internal read buffer to be size bytes. More... | |
| bool | setSocketDescriptor (int socketDescriptor, SocketState state=ConnectedState, OpenMode openMode=ReadWrite) |
| Initializes QAbstractSocket with the native socket descriptor socketDescriptor. More... | |
| void | setSocketOption (QAbstractSocket::SocketOption option, const QVariant &value) |
| Sets the given option to the value described by value. More... | |
| int | socketDescriptor () const |
| Returns the native socket descriptor of the QAbstractSocket object if this is available; otherwise returns -1. More... | |
| QVariant | socketOption (QAbstractSocket::SocketOption option) |
| Returns the value of the option option. More... | |
| SocketType | socketType () const |
| Returns the socket type (TCP, UDP, or other). More... | |
| SocketState | state () const |
| Returns the state of the socket. More... | |
| bool | waitForBytesWritten (int msecs=30000) |
| Reimplemented Function More... | |
| bool | waitForConnected (int msecs=30000) |
| Waits until the socket is connected, up to msecs milliseconds. More... | |
| bool | waitForDisconnected (int msecs=30000) |
| Waits until the socket has disconnected, up to msecs milliseconds. More... | |
| bool | waitForReadyRead (int msecs=30000) |
| This function blocks until new data is available for reading and the QIODevice::readyRead() signal has been emitted. More... | |
| virtual | ~QAbstractSocket () |
| Destroys the socket. More... | |
| Public Functions inherited from QIODevice | |
| QString | errorString () const |
| Returns a human-readable description of the last device error that occurred. More... | |
| bool | getChar (char *c) |
| Reads one character from the device and stores it in c. More... | |
| bool | isOpen () const |
| Returns true if the device is open; otherwise returns false. More... | |
| bool | isReadable () const |
| Returns true if data can be read from the device; otherwise returns false. More... | |
| bool | isTextModeEnabled () const |
| Returns true if the Text flag is enabled; otherwise returns false. More... | |
| bool | isWritable () const |
| Returns true if data can be written to the device; otherwise returns false. More... | |
| virtual bool | open (OpenMode mode) |
| Opens the device and sets its OpenMode to mode. More... | |
| OpenMode | openMode () const |
| Returns the mode in which the device has been opened; i.e. More... | |
| qint64 | peek (char *data, qint64 maxlen) |
| Reads at most maxSize bytes from the device into data, without side effects (i. More... | |
| QByteArray | peek (qint64 maxlen) |
| Peeks at most maxSize bytes from the device, returning the data peeked as a QByteArray. More... | |
| virtual qint64 | pos () const |
| For random-access devices, this function returns the position that data is written to or read from. More... | |
| bool | putChar (char c) |
| Writes the character c to the device. More... | |
| QIODevice () | |
| Constructs a QIODevice object. More... | |
| QIODevice (QObject *parent) | |
| Constructs a QIODevice object with the given parent. More... | |
| qint64 | read (char *data, qint64 maxlen) |
| Reads at most maxSize bytes from the device into data, and returns the number of bytes read. More... | |
| QByteArray | read (qint64 maxlen) |
| Reads at most maxSize bytes from the device, and returns the data read as a QByteArray. More... | |
| QByteArray | readAll () |
| Reads all available data from the device, and returns it as a QByteArray. More... | |
| qint64 | readLine (char *data, qint64 maxlen) |
| This function reads a line of ASCII characters from the device, up to a maximum of maxSize - 1 bytes, stores the characters in data, and returns the number of bytes read. More... | |
| QByteArray | readLine (qint64 maxlen=0) |
| Reads a line from the device, but no more than maxSize characters, and returns the result as a QByteArray. More... | |
| virtual bool | reset () |
| Seeks to the start of input for random-access devices. More... | |
| virtual bool | seek (qint64 pos) |
| For random-access devices, this function sets the current position to pos, returning true on success, or false if an error occurred. More... | |
| void | setTextModeEnabled (bool enabled) |
| If enabled is true, this function sets the Text flag on the device; otherwise the Text flag is removed. More... | |
| virtual qint64 | size () const |
| For open random-access devices, this function returns the size of the device. More... | |
| void | ungetChar (char c) |
| Puts the character c back into the device, and decrements the current position unless the position is 0. More... | |
| qint64 | write (const char *data, qint64 len) |
| Writes at most maxSize bytes of data from data to the device. More... | |
| qint64 | write (const char *data) |
| Writes data from a zero-terminated string of 8-bit characters to the device. More... | |
| qint64 | write (const QByteArray &data) |
| Writes the content of byteArray to the device. More... | |
| virtual | ~QIODevice () |
| The destructor is virtual, and QIODevice is an abstract base class. More... | |
| Public Functions inherited from QObject | |
| bool | blockSignals (bool b) |
| If block is true, signals emitted by this object are blocked (i.e., emitting a signal will not invoke anything connected to it). More... | |
| const QObjectList & | children () const |
| Returns a list of child objects. More... | |
| bool | connect (const QObject *sender, const char *signal, const char *member, Qt::ConnectionType type=Qt::AutoConnection) const |
| bool | disconnect (const char *signal=0, const QObject *receiver=0, const char *member=0) |
| bool | disconnect (const QObject *receiver, const char *member=0) |
| void | dumpObjectInfo () |
| Dumps information about signal connections, etc. More... | |
| void | dumpObjectTree () |
| Dumps a tree of children to the debug output. More... | |
| QList< QByteArray > | dynamicPropertyNames () const |
| Returns the names of all properties that were dynamically added to the object using setProperty(). More... | |
| virtual bool | event (QEvent *) |
| This virtual function receives events to an object and should return true if the event e was recognized and processed. More... | |
| virtual bool | eventFilter (QObject *, QEvent *) |
| Filters events if this object has been installed as an event filter for the watched object. More... | |
| template<typename T > | |
| T | findChild (const QString &aName=QString()) const |
| Returns the child of this object that can be cast into type T and that is called name, or 0 if there is no such object. More... | |
| template<typename T > | |
| QList< T > | findChildren (const QString &aName=QString()) const |
| Returns all children of this object with the given name that can be cast to type T, or an empty list if there are no such objects. More... | |
| template<typename T > | |
| QList< T > | findChildren (const QRegExp &re) const |
| bool | inherits (const char *classname) const |
| Returns true if this object is an instance of a class that inherits className or a QObject subclass that inherits className; otherwise returns false. More... | |
| void | installEventFilter (QObject *) |
| Installs an event filter filterObj on this object. More... | |
| bool | isWidgetType () const |
| Returns true if the object is a widget; otherwise returns false. More... | |
| void | killTimer (int id) |
| Kills the timer with timer identifier, id. More... | |
| virtual const QMetaObject * | metaObject () const |
| Returns a pointer to the meta-object of this object. More... | |
| void | moveToThread (QThread *thread) |
| Changes the thread affinity for this object and its children. More... | |
| QString | objectName () const |
| QObject * | parent () const |
| Returns a pointer to the parent object. More... | |
| QVariant | property (const char *name) const |
| Returns the value of the object's name property. More... | |
| Q_INVOKABLE | QObject (QObject *parent=0) |
| Constructs an object with parent object parent. More... | |
| void | removeEventFilter (QObject *) |
| Removes an event filter object obj from this object. More... | |
| void | setObjectName (const QString &name) |
| void | setParent (QObject *) |
| Makes the object a child of parent. More... | |
| bool | setProperty (const char *name, const QVariant &value) |
| Sets the value of the object's name property to value. More... | |
| void | setUserData (uint id, QObjectUserData *data) |
| bool | signalsBlocked () const |
| Returns true if signals are blocked; otherwise returns false. More... | |
| int | startTimer (int interval) |
| Starts a timer and returns a timer identifier, or returns zero if it could not start a timer. More... | |
| QThread * | thread () const |
| Returns the thread in which the object lives. More... | |
| QObjectUserData * | userData (uint id) const |
| virtual | ~QObject () |
| Destroys the object, deleting all its child objects. More... | |
Additional Inherited Members | |
| Public Slots inherited from QObject | |
| void | deleteLater () |
| Schedules this object for deletion. More... | |
| Signals inherited from QAbstractSocket | |
| void | connected () |
| This signal is emitted after connectToHost() has been called and a connection has been successfully established. More... | |
| void | disconnected () |
| This signal is emitted when the socket has been disconnected. More... | |
| void | error (QAbstractSocket::SocketError) |
| This signal is emitted after an error occurred. More... | |
| void | hostFound () |
| This signal is emitted after connectToHost() has been called and the host lookup has succeeded. More... | |
| void | proxyAuthenticationRequired (const QNetworkProxy &proxy, QAuthenticator *authenticator) |
| void | stateChanged (QAbstractSocket::SocketState) |
| This signal is emitted whenever QAbstractSocket's state changes. More... | |
| Signals inherited from QIODevice | |
| void | aboutToClose () |
| This signal is emitted when the device is about to close. More... | |
| void | bytesWritten (qint64 bytes) |
| This signal is emitted every time a payload of data has been written to the device. More... | |
| void | readChannelFinished () |
| This signal is emitted when the input (reading) stream is closed in this device. More... | |
| void | readyRead () |
| This signal is emitted once every time new data is available for reading from the device. More... | |
| Signals inherited from QObject | |
| void | destroyed (QObject *=0) |
| This signal is emitted immediately before the object obj is destroyed, and can not be blocked. More... | |
| Static Public Functions inherited from QObject | |
| static bool | connect (const QObject *sender, const char *signal, const QObject *receiver, const char *member, Qt::ConnectionType=Qt::AutoConnection) |
| Creates a connection of the given type from the signal in the sender object to the method in the receiver object. More... | |
| static bool | connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type=Qt::AutoConnection) |
| static bool | disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *member) |
| Disconnects signal in object sender from method in object receiver. More... | |
| static bool | disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &member) |
| static uint | registerUserData () |
| static QString | tr (const char *sourceText, const char *comment=0, int n=-1) |
| static QString | trUtf8 (const char *sourceText, const char *comment=0, int n=-1) |
| Static Public Variables inherited from QObject | |
| static const QMetaObject | staticMetaObject |
| This variable stores the meta-object for the class. More... | |
| Protected Slots inherited from QAbstractSocket | |
| void | connectToHostImplementation (const QString &hostName, quint16 port, OpenMode mode=ReadWrite) |
| Contains the implementation of connectToHost(). More... | |
| void | disconnectFromHostImplementation () |
| Contains the implementation of disconnectFromHost(). More... | |
| Protected Functions inherited from QAbstractSocket | |
| QAbstractSocket (SocketType socketType, QAbstractSocketPrivate &dd, QObject *parent=0) | |
| Constructs a new abstract socket of type socketType. More... | |
| qint64 | readData (char *data, qint64 maxlen) |
| Reimplemented Function More... | |
| qint64 | readLineData (char *data, qint64 maxlen) |
| Reimplemented Function More... | |
| void | setLocalAddress (const QHostAddress &address) |
| Sets the address on the local side of a connection to address. More... | |
| void | setLocalPort (quint16 port) |
| Sets the port on the local side of a connection to port. More... | |
| void | setPeerAddress (const QHostAddress &address) |
| Sets the address of the remote side of the connection to address. More... | |
| void | setPeerName (const QString &name) |
| Sets the host name of the remote peer to name. More... | |
| void | setPeerPort (quint16 port) |
| Sets the port of the remote side of the connection to port. More... | |
| void | setSocketError (SocketError socketError) |
| Sets the type of error that last occurred to socketError. More... | |
| void | setSocketState (SocketState state) |
| Sets the state of the socket to state. More... | |
| qint64 | writeData (const char *data, qint64 len) |
| Reimplemented Function More... | |
| Protected Functions inherited from QIODevice | |
| QIODevice (QIODevicePrivate &dd, QObject *parent=0) | |
| void | setErrorString (const QString &errorString) |
| Sets the human readable description of the last device error that occurred to str. More... | |
| void | setOpenMode (OpenMode openMode) |
| Sets the OpenMode of the device to openMode. More... | |
| Protected Functions inherited from QObject | |
| virtual void | childEvent (QChildEvent *) |
| This event handler can be reimplemented in a subclass to receive child events. More... | |
| virtual void | connectNotify (const char *signal) |
| This virtual function is called when something has been connected to signal in this object. More... | |
| virtual void | customEvent (QEvent *) |
| This event handler can be reimplemented in a subclass to receive custom events. More... | |
| virtual void | disconnectNotify (const char *signal) |
| This virtual function is called when something has been disconnected from signal in this object. More... | |
| QObject (QObjectPrivate &dd, QObject *parent=0) | |
| int | receivers (const char *signal) const |
| Returns the number of receivers connected to the signal. More... | |
| QObject * | sender () const |
| Returns a pointer to the object that sent the signal, if called in a slot activated by a signal; otherwise it returns 0. More... | |
| int | senderSignalIndex () const |
| virtual void | timerEvent (QTimerEvent *) |
| This event handler can be reimplemented in a subclass to receive timer events for the object. More... | |
| Protected Variables inherited from QObject | |
| QScopedPointer< QObjectData > | d_ptr |
| Static Protected Variables inherited from QObject | |
| static const QMetaObject | staticQtMetaObject |
| Related Functions inherited from QObject | |
| T | qFindChildqFindChildren (const QObject *obj, const QString &name)() |
| QList< T > | qFindChildrenqFindChildren (const QObject *obj, const QString &name)() |
| QList< T > | qFindChildrenqFindChildren (const QObject *obj, const QRegExp ®Exp)() |
| T * | qobject_cast (QObject *object) |
| QObjectList | |
| void * | qt_find_obj_child (QObject *parent, const char *type, const QString &name) |
| Returns a pointer to the object named name that inherits type and with a given parent. More... | |
The QUdpSocket class provides a UDP socket.
UDP (User Datagram Protocol) is a lightweight, unreliable, datagram-oriented, connectionless protocol. It can be used when reliability isn't important. QUdpSocket is a subclass of QAbstractSocket that allows you to send and receive UDP datagrams.
The most common way to use this class is to bind to an address and port using bind(), then call writeDatagram() and readDatagram() to transfer data. If you want to use the standard QIODevice functions read(), readLine(), write(), etc., you must first connect the socket directly to a peer by calling connectToHost().
The socket emits the bytesWritten() signal every time a datagram is written to the network. If you just want to send datagrams, you don't need to call bind().
The readyRead() signal is emitted whenever datagrams arrive. In that case, hasPendingDatagrams() returns true. Call pendingDatagramSize() to obtain the size of the first pending datagram, and readDatagram() to read it.
Example:
QUdpSocket also supports UDP multicast. Use joinMulticastGroup() and leaveMulticastGroup() to control group membership, and QAbstractSocket::MulticastTtlOption and QAbstractSocket::MulticastLoopbackOption to set the TTL and loopback socket options. Use setMulticastInterface() to control the outgoing interface for multicast datagrams, and multicastInterface() to query it.
With QUdpSocket, you can also establish a virtual connection to a UDP server using connectToHost() and then use read() and write() to exchange datagrams without specifying the receiver for each datagram.
The Broadcast Sender, Broadcast Receiver, Multicast Sender, and Multicast Receiver examples illustrate how to use QUdpSocket in applications.
On Symbian, processes which use this class must have the NetworkServices platform security capability. If the client process lacks this capability, operations will result in a panic.
Platform security capabilities are added via the TARGET.CAPABILITY qmake variable.
Definition at line 59 of file qudpsocket.h.
| enum QUdpSocket::BindFlag |
This enum describes the different flags you can pass to modify the behavior of QUdpSocket::bind().
| Enumerator | |
|---|---|
| DefaultForPlatform | |
| ShareAddress | |
| DontShareAddress | |
| ReuseAddressHint | |
Definition at line 63 of file qudpsocket.h.
|
explicit |
Creates a QUdpSocket object.
parent is passed to the QObject constructor.
Definition at line 227 of file qudpsocket.cpp.
|
virtual |
Destroys the socket, closing the connection if necessary.
Definition at line 238 of file qudpsocket.cpp.
| bool QUdpSocket::bind | ( | const QHostAddress & | address, |
| quint16 | port | ||
| ) |
Binds this socket to the address address and the port port.
When bound, the signal readyRead() is emitted whenever a UDP datagram arrives on the specified address and port. This function is useful to write UDP servers.
On success, the functions returns true and the socket enters BoundState; otherwise it returns false.
The socket is bound using the DefaultForPlatform BindMode.
Definition at line 255 of file qudpsocket.cpp.
Referenced by bind(), and QSocks5SocketEngine::bind().
| bool QUdpSocket::bind | ( | quint16 | port = 0 | ) |
Binds to QHostAddress:Any on port port.
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
Definition at line 337 of file qudpsocket.cpp.
| bool QUdpSocket::bind | ( | const QHostAddress & | address, |
| quint16 | port, | ||
| BindMode | mode | ||
| ) |
Binds to address on port port, using the BindMode mode.
Definition at line 289 of file qudpsocket.cpp.
| bool QUdpSocket::bind | ( | quint16 | port, |
| BindMode | mode | ||
| ) |
Binds to QHostAddress:Any on port port, using the BindMode mode.
Definition at line 351 of file qudpsocket.cpp.
| bool QUdpSocket::hasPendingDatagrams | ( | ) | const |
Returns true if at least one datagram is waiting to be read; otherwise returns false.
Definition at line 490 of file qudpsocket.cpp.
| bool QUdpSocket::joinMulticastGroup | ( | const QHostAddress & | groupAddress | ) |
Joins the the multicast group specified by groupAddress on the default interface chosen by the operating system.
The socket must be in BoundState, otherwise an error occurs.
This function returns true if successful; otherwise it returns false and sets the socket error accordingly.
Definition at line 373 of file qudpsocket.cpp.
| bool QUdpSocket::joinMulticastGroup | ( | const QHostAddress & | groupAddress, |
| const QNetworkInterface & | iface | ||
| ) |
Joins the multicast group address groupAddress on the interface iface.
Definition at line 390 of file qudpsocket.cpp.
| bool QUdpSocket::leaveMulticastGroup | ( | const QHostAddress & | groupAddress | ) |
Leaves the multicast group specified by groupAddress on the default interface chosen by the operating system.
The socket must be in BoundState, otherwise an error occurs.
This function returns true if successful; otherwise it returns false and sets the socket error accordingly.
Definition at line 413 of file qudpsocket.cpp.
| bool QUdpSocket::leaveMulticastGroup | ( | const QHostAddress & | groupAddress, |
| const QNetworkInterface & | iface | ||
| ) |
Leaves the multicast group specified by groupAddress on the interface iface.
Definition at line 430 of file qudpsocket.cpp.
| QNetworkInterface QUdpSocket::multicastInterface | ( | ) | const |
Returns the interface for the outgoing interface for multicast datagrams.
This corresponds to the IP_MULTICAST_IF socket option for IPv4 sockets and the IPV6_MULTICAST_IF socket option for IPv6 sockets. If no interface has been previously set, this function returns an invalid QNetworkInterface. The socket must be in BoundState, otherwise an invalid QNetworkInterface is returned.
Definition at line 452 of file qudpsocket.cpp.
| qint64 QUdpSocket::pendingDatagramSize | ( | ) | const |
Returns the size of the first pending UDP datagram.
If there is no datagram available, this function returns -1.
Definition at line 502 of file qudpsocket.cpp.
| qint64 QUdpSocket::readDatagram | ( | char * | data, |
| qint64 | maxSize, | ||
| QHostAddress * | address = 0, |
||
| quint16 * | port = 0 |
||
| ) |
Receives a datagram no larger than maxSize bytes and stores it in data.
The sender's host address and port is stored in address and *port (unless the pointers are 0).
Returns the size of the datagram on success; otherwise returns -1.
If maxSize is too small, the rest of the datagram will be lost. To avoid loss of data, call pendingDatagramSize() to determine the size of the pending datagram before attempting to read it. If maxSize is 0, the datagram will be discarded.
Definition at line 583 of file qudpsocket.cpp.
Referenced by QSocks5SocketEngine::bind().
| void QUdpSocket::setMulticastInterface | ( | const QNetworkInterface & | iface | ) |
Sets the outgoing interface for multicast datagrams to the interface iface.
This corresponds to the IP_MULTICAST_IF socket option for IPv4 sockets and the IPV6_MULTICAST_IF socket option for IPv6 sockets. The socket must be in BoundState, otherwise this function does nothing.
Definition at line 472 of file qudpsocket.cpp.
| qint64 QUdpSocket::writeDatagram | ( | const char * | data, |
| qint64 | size, | ||
| const QHostAddress & | address, | ||
| quint16 | port | ||
| ) |
Sends the datagram at data of size size to the host address address at port port.
Returns the number of bytes sent on success; otherwise returns -1.
Datagrams are always written as one block. The maximum size of a datagram is highly platform-dependent, but can be as low as 8192 bytes. If the datagram is too large, this function will return -1 and error() will return DatagramTooLargeError.
Sending datagrams larger than 512 bytes is in general disadvised, as even if they are sent successfully, they are likely to be fragmented by the IP layer before arriving at their final destination.
Definition at line 532 of file qudpsocket.cpp.
|
inline |
Sends the datagram datagram to the host address host and at port port.
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
Definition at line 96 of file qudpsocket.h.