QAbstractSocket: update setSocketOption documentation

Specify that it should not be called until the internal
socket engine has been created.

Given that most usages of this function will be on QUdpSockets
and that people will likely want to call bind() on those
anyway, we just document this rather than implement some
caching mechanism.

Pick-to: 6.3 6.2
Fixes: QTBUG-67576
Change-Id: Ia5d3ade95460b7c5685681ee098f1c00bff43a90
Reviewed-by: Timur Pocheptsov <timur.pocheptsov@qt.io>
Reviewed-by: Edward Welbourne <edward.welbourne@qt.io>
Reviewed-by: Thiago Macieira <thiago.macieira@intel.com>
This commit is contained in:
Mårten Nordheim 2022-03-03 18:29:32 +01:00
parent 034d8898f8
commit e83c9e4e8e

View File

@ -1946,6 +1946,10 @@ bool QAbstractSocket::setSocketDescriptor(qintptr socketDescriptor, SocketState
\since 4.6
Sets the given \a option to the value described by \a value.
\note Since the options are set on an internal socket the options
only apply if the socket has been created. This is only guaranteed to
have happened after a call to bind(), or when connected() has been emitted.
\sa socketOption()
*/
void QAbstractSocket::setSocketOption(QAbstractSocket::SocketOption option, const QVariant &value)