summaryrefslogtreecommitdiffstats
path: root/src/network/doc/snippets/code
diff options
context:
space:
mode:
authorMate Barany <mate.barany@qt.io>2025-08-12 15:57:17 +0200
committerMate Barany <mate.barany@qt.io>2025-08-14 12:45:53 +0000
commit8b82134ed380721a10b9f42a18124b9cefe23fa9 (patch)
treeee9d82990d675af25d19eb5b87661d776620d028 /src/network/doc/snippets/code
parentad1e4e541cfc1540a3c1968c6082ec13974dc262 (diff)
Add an example snippet to QNetworkInformation
The methods are well-documented but it probably does not hurt to add a small snippet about a simple example use case. Task-number: QTBUG-136625 Pick-to: 6.10 Change-Id: I267250faae4a062ed514a2e0bccca57f7bd8a0b3 Reviewed-by: Juha Vuolle <juha.vuolle@qt.io>
Diffstat (limited to 'src/network/doc/snippets/code')
-rw-r--r--src/network/doc/snippets/code/src_network_kernel_qnetworkinformation.cpp49
1 files changed, 49 insertions, 0 deletions
diff --git a/src/network/doc/snippets/code/src_network_kernel_qnetworkinformation.cpp b/src/network/doc/snippets/code/src_network_kernel_qnetworkinformation.cpp
new file mode 100644
index 00000000000..a68579d0740
--- /dev/null
+++ b/src/network/doc/snippets/code/src_network_kernel_qnetworkinformation.cpp
@@ -0,0 +1,49 @@
+// Copyright (C) 2025 The Qt Company Ltd.
+// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause
+
+//![file]
+#include <QCoreApplication>
+#include <QNetworkInformation>
+#include <QDebug>
+
+void onReachabilityChanged(QNetworkInformation::Reachability reachability) {
+ switch (reachability) {
+ case QNetworkInformation::Reachability::Unknown:
+ qDebug() << "Network reachability is unknown.";
+ break;
+ case QNetworkInformation::Reachability::Disconnected:
+ qDebug() << "Network is disconnected.";
+ break;
+ case QNetworkInformation::Reachability::Local:
+ qDebug() << "Network is locally reachable.";
+ break;
+ case QNetworkInformation::Reachability::Site:
+ qDebug() << "Network can reach the site.";
+ break;
+ case QNetworkInformation::Reachability::Online:
+ qDebug() << "Network is online.";
+ break;
+ }
+}
+
+int main(int argc, char *argv[]) {
+ QCoreApplication a(argc, argv);
+
+ // Check if QNetworkInformation is supported
+ if (!QNetworkInformation::loadDefaultBackend()) {
+ qWarning() << "QNetworkInformation is not supported on this platform or backend.";
+ return 1;
+ }
+
+ QNetworkInformation* netInfo = QNetworkInformation::instance();
+
+ // Connect to the reachabilityChanged signal
+ QObject::connect(netInfo, &QNetworkInformation::reachabilityChanged,
+ &onReachabilityChanged);
+
+ // Print initial status
+ onReachabilityChanged(netInfo->reachability());
+
+ return a.exec();
+}
+//![file]