Host.h

Go to the documentation of this file.

// Host.h -- interface for the Host class

#ifndef HOST_H_
#define HOST_H_

#ifdef _MSC_VER
#pragma once
#endif // MSVC

#include <string>
#include <vector>

// IpAddress class
#include "IpAddress.h"


// Host

// Represents a device on a TCP/IP network that can be identified
// by a logical IP address

class Host
{
public:
    // Constructors.
        Host();
    Host( const std::string& name );
    Host( const IpAddress& address );
    Host( const hostent& host );
    Host( const Host& host );

    // Assignment and comparison operators
    Host& operator=( const Host& host );
    bool operator==( const Host& host ) const;
    bool operator<( const Host& host ) const;

    // Contains the DNS name of the host
        std::string getName() const;

    // Provides an collection of other DNS names that resolve to the Host
    const std::vector<std::string>& getAliases() const;

    // retrieve collection of IP addresses.
    const std::vector<IpAddress>& getIpAddresses() const;

    // Verification 
    bool isDefined() const;

    // Retrive the host for the local machine
    static const Host& getLocalhost();

    // Standard c++ iostream insertor
        std::ostream& operator<<( std::ostream& stream) const;

protected:
        // Overridable variable manipulation
        void set( const std::string& name );
        void set( const IpAddress& name );
        void set( const hostent& host );

    // Retrieving hostent from the given address entry, return success/failure
    static bool find(const std::string& name,struct hostent* data) throw();
        static bool find(const IpAddress& address,struct hostent* data) throw();

private:
        std::string hostName;
    std::vector< std::string > ipAliases;
    std::vector< IpAddress > ipAddresses;
    static std::auto_ptr<Host> ipLocalhost;
};


#endif // HOST_H_

---