/****************************************************************************

**

** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).

** All rights reserved.

** Contact: Nokia Corporation (qt-info@nokia.com)

**

** This file is part of the QtNetwork module of the Qt Toolkit.

**

** $QT_BEGIN_LICENSE:LGPL$

** No Commercial Usage

** This file contains pre-release code and may not be distributed.

** You may use this file in accordance with the terms and conditions

** contained in the Technology Preview License Agreement accompanying

** this package.

**

** GNU Lesser General Public License Usage

** Alternatively, this file may be used under the terms of the GNU Lesser

** General Public License version 2.1 as published by the Free Software

** Foundation and appearing in the file LICENSE.LGPL included in the

** packaging of this file.  Please review the following information to

** ensure the GNU Lesser General Public License version 2.1 requirements

** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.

**

** In addition, as a special exception, Nokia gives you certain additional

** rights.  These rights are described in the Nokia Qt LGPL Exception

** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.

**

** If you have questions regarding the use of this file, please contact

** Nokia at qt-info@nokia.com.

**

**

**

**

**

**

**

**

** $QT_END_LICENSE$

**

****************************************************************************/

#ifndef QHOSTADDRESS_H

#define QHOSTADDRESS_H

#include <QtCore/qpair.h>

#include <QtCore/qstring.h>

#include <QtCore/qscopedpointer.h>

#include <QtNetwork/qabstractsocket.h>

struct sockaddr;

QT_BEGIN_HEADER

QT_BEGIN_NAMESPACE

QT_MODULE(Network)

class QHostAddressPrivate;

class Q_NETWORK_EXPORT QIPv6Address

{

public:

    inline quint8 &operator [](int index) { return c[index]; }

    inline quint8 operator [](int index) const { return c[index]; }

    quint8 c[16];

};

typedef QIPv6Address Q_IPV6ADDR;

class Q_NETWORK_EXPORT QHostAddress

{

public:

    enum SpecialAddress {

        Null,

        Broadcast,

        LocalHost,

        LocalHostIPv6,

        Any,

        AnyIPv6

    };

    QHostAddress();

    explicit QHostAddress(quint32 ip4Addr);

    explicit QHostAddress(quint8 *ip6Addr);

    explicit QHostAddress(const Q_IPV6ADDR &ip6Addr);

    explicit QHostAddress(const sockaddr *sockaddr);

    explicit QHostAddress(const QString &address);

    QHostAddress(const QHostAddress &copy);

    QHostAddress(SpecialAddress address);

    ~QHostAddress();

    QHostAddress &operator=(const QHostAddress &other);

    QHostAddress &operator=(const QString &address);

    void setAddress(quint32 ip4Addr);

    void setAddress(quint8 *ip6Addr);

    void setAddress(const Q_IPV6ADDR &ip6Addr);

    void setAddress(const sockaddr *sockaddr);

    bool setAddress(const QString &address);

    QAbstractSocket::NetworkLayerProtocol protocol() const;

    quint32 toIPv4Address() const;

    Q_IPV6ADDR toIPv6Address() const;

    QString toString() const;

    QString scopeId() const;

    void setScopeId(const QString &id);

    bool operator ==(const QHostAddress &address) const;

    bool operator ==(SpecialAddress address) const;

    inline bool operator !=(const QHostAddress &address) const

    { return !operator==(address); }

    inline bool operator !=(SpecialAddress address) const

    { return !operator==(address); }

    bool isNull() const;

    void clear();

#ifdef QT3_SUPPORT

    inline QT3_SUPPORT quint32 ip4Addr() const { return toIPv4Address(); }

    inline QT3_SUPPORT bool isIPv4Address() const { return protocol() == QAbstractSocket::IPv4Protocol

                                                      || protocol() == QAbstractSocket::UnknownNetworkLayerProtocol; }

    inline QT3_SUPPORT bool isIp4Addr() const  { return protocol() == QAbstractSocket::IPv4Protocol

                                                      || protocol() == QAbstractSocket::UnknownNetworkLayerProtocol; }

    inline QT3_SUPPORT bool isIPv6Address() const { return protocol() == QAbstractSocket::IPv6Protocol; }

#endif

    bool isInSubnet(const QHostAddress &subnet, int netmask) const;

    bool isInSubnet(const QPair<QHostAddress, int> &subnet) const;

    static QPair<QHostAddress, int> parseSubnet(const QString &subnet);

protected:

    QScopedPointer<QHostAddressPrivate> d;

};

inline bool operator ==(QHostAddress::SpecialAddress address1, const QHostAddress &address2)

{ return address2 == address1; }

#ifndef QT_NO_DEBUG_STREAM

Q_NETWORK_EXPORT QDebug operator<<(QDebug, const QHostAddress &);

#endif

Q_NETWORK_EXPORT uint qHash(const QHostAddress &key);

#ifndef QT_NO_DATASTREAM

Q_NETWORK_EXPORT QDataStream &operator<<(QDataStream &, const QHostAddress &);

Q_NETWORK_EXPORT QDataStream &operator>>(QDataStream &, QHostAddress &);

#endif

QT_END_NAMESPACE

QT_END_HEADER

#endif // QHOSTADDRESS_H