internetaddress.h

Go to the documentation of this file.

// ##########################################################################
// ####                                                                  ####
// ####                      RTP Audio Server Project                    ####
// ####                    ============================                  ####
// ####                                                                  ####
// #### Internet Address                                                 ####
// ####                                                                  ####
// #### Version 1.00  --  February 16, 2001                              ####
// ####                                                                  ####
// #### Copyright (C) 1999  Thomas Dreibholz                             ####
// ####               2000  Universität Bonn, Abt. IV                    ####
// ####               2001  EMail: dreibh@iem.uni-due.de                 ####
// ####                     WWW:   https://www.uni-due.de/~be0001        ####
// ####                                                                  ####
// ##########################################################################


#ifndef INTERNETADDRESS_H
#define INTERNETADDRESS_H


#include "system.h"
#include "strings.h"
#include "socketaddress.h"
#include "portableaddress.h"


#include <netinet/in.h>
#include <resolv.h>


namespace Coral {


class InternetAddress : virtual public SocketAddress
{
   // ====== Constructors/Destructor ========================================
   public:
   InternetAddress();

   InternetAddress(const InternetAddress& address);

   InternetAddress(const String& address);      

   InternetAddress(const String& hostName,
                   const card16 port);

   InternetAddress(const card16 port);

   InternetAddress(sockaddr* address, socklen_t length);

   ~InternetAddress();


   // ====== Initialization =================================================
   void reset();

   void init(const InternetAddress& address);

   void init(const card16 port);

   void init(const String& hostName, const card16 port);


   // ====== Operators ======================================================
   inline InternetAddress& operator=(const InternetAddress& source);


   // ====== Address manipulation ===========================================
   inline card16 getPort() const;

   inline void setPort(const card16 port);

   // ====== Print format ===================================================
   enum PrintFormat {
      PF_Address  = (1 << 0),
      PF_Hostname = (1 << 1),
      PF_Full     = PF_Address | PF_Hostname
   };

   inline PrintFormat getPrintFormat() const;

   inline void setPrintFormat(const PrintFormat format);

   
   // ====== Address functions ==============================================
   bool isValid() const;

   inline bool isNull() const;

   String getAddressString() const;

   inline bool isIPv4() const;

   inline bool isIPv6() const;


   // ====== Get local address for a connection =============================
   static InternetAddress getLocalAddress(const InternetAddress& peer);

   
   // ====== Get/set system sockaddr structure ==============================
   cardinal getSystemAddress(sockaddr*       buffer,
                             const socklen_t length,
                             const cardinal  type) const;

   bool setSystemAddress(sockaddr* address, const socklen_t length);


   // ====== IPv6 support functions ========================================
   static cardinal getHostByName(const String& name, card16* myadr);

   static inline bool hasIPv6();

   static bool UseIPv6;
    

    // ====== Comparision operators =========================================
   int operator==(const InternetAddress& address) const;

   inline int operator!=(const InternetAddress& address) const;

   int operator<(const InternetAddress& address) const;

   inline int operator<=(const InternetAddress& address) const;

   int operator>(const InternetAddress& address) const;

   inline int operator>=(const InternetAddress& address) const;


   // ====== Conversion from and to PortableAddress =========================
   inline PortableAddress getPortableAddress() const;

   InternetAddress(const PortableAddress& address);

   void init(const PortableAddress& address);


   // ====== Private data ===================================================
   private:
   static bool checkIPv6();


   private:
   card16 Host[8];

   card16 Port;

   PrintFormat Format;

   bool Valid;
};


}


#include "internetaddress.icc"


#endif