Doc: Modularize QtNetwork documentation.
[profile/ivi/qtbase.git] / src / network / doc / snippets / code / src_network_kernel_qhostinfo.cpp
1 /****************************************************************************
2 **
3 ** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies).
4 ** Contact: http://www.qt-project.org/
5 **
6 ** This file is part of the documentation of the Qt Toolkit.
7 **
8 ** $QT_BEGIN_LICENSE:BSD$
9 ** You may use this file under the terms of the BSD license as follows:
10 **
11 ** "Redistribution and use in source and binary forms, with or without
12 ** modification, are permitted provided that the following conditions are
13 ** met:
14 **   * Redistributions of source code must retain the above copyright
15 **     notice, this list of conditions and the following disclaimer.
16 **   * Redistributions in binary form must reproduce the above copyright
17 **     notice, this list of conditions and the following disclaimer in
18 **     the documentation and/or other materials provided with the
19 **     distribution.
20 **   * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor
21 **     the names of its contributors may be used to endorse or promote
22 **     products derived from this software without specific prior written
23 **     permission.
24 **
25 ** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
26 ** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
27 ** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
28 ** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
29 ** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
30 ** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
31 ** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
32 ** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
33 ** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
34 ** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
35 ** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
36 **
37 ** $QT_END_LICENSE$
38 **
39 ****************************************************************************/
40
41 //! [0]
42 // To find the IP address of qt.nokia.com
43 QHostInfo::lookupHost("qt.nokia.com",
44                       this, SLOT(printResults(QHostInfo)));
45
46 // To find the host name for 4.2.2.1
47 QHostInfo::lookupHost("4.2.2.1",
48                       this, SLOT(printResults(QHostInfo)));
49 //! [0]
50
51
52 //! [1]
53 QHostInfo info = QHostInfo::fromName("qt.nokia.com");
54 //! [1]
55
56
57 //! [2]
58 QHostInfo::lookupHost("www.kde.org",
59                       this, SLOT(lookedUp(QHostInfo)));
60 //! [2]
61
62
63 //! [3]
64 void MyWidget::lookedUp(const QHostInfo &host)
65 {
66     if (host.error() != QHostInfo::NoError) {
67         qDebug() << "Lookup failed:" << host.errorString();
68         return;
69     }
70
71     foreach (const QHostAddress &address, host.addresses())
72         qDebug() << "Found address:" << address.toString();
73 }
74 //! [3]
75
76
77 //! [4]
78 QHostInfo::lookupHost("4.2.2.1",
79                       this, SLOT(lookedUp(QHostInfo)));
80 //! [4]
81
82
83 //! [5]
84 QHostInfo info;
85 ...
86 if (!info.addresses().isEmpty()) {
87     QHostAddress address = info.addresses().first();
88     // use the first IP address
89 }
90 //! [5]