subnet_calculator.h

Go to the documentation of this file.

#ifndef SUBNET_CALCULATOR_CLASS
#define SUBNET_CALCULATOR_CLASS

/*****************************************************************************\
*                                                                             *
*  Name   : subnet_calculator                                                 *
*  Author : Chris Koeritz                                                     *
*                                                                             *
*  Purpose:                                                                   *
*                                                                             *
*    Provides an easy way to determine the range of a subnet given the        *
*  subnet mask and a sample IP address.                                       *
*                                                                             *
*******************************************************************************
* Copyright (c) 1997-$now By Author.  This program is free software; you can  *
* redistribute it and/or modify it under the terms of the GNU General Public  *
* License as published by the Free Software Foundation; either version 2 of   *
* the License or (at your option) any later version.  This is online at:      *
*     http://www.fsf.org/copyleft/gpl.html                                    *
* Please send any updates to: fred@gruntose.com                               *
\*****************************************************************************/

#include "sockets_dll.h"

class SOCKETS_CLASS_STYLE subnet_calculator
{
public:
  subnet_calculator(const istring &subnet_mask, const istring &ip_address);
  ~subnet_calculator();

  istring convert(u_int num_format);
  u_int convert(const istring &ip_format);
    // converts between the numerical and string forms of the ip address.

  // these two functions return the computed low / high range of the subnet.
  // they ensure that the subnet calculator is valid by calling the calculate
  // method if it hasn't already been called.
  const istring &low_end();
  const istring &high_end();

  // these allow observation and modification of the parameters that are needed
  // to calculate the subnet range.
  const istring &subnet_mask() const;
  void subnet_mask(const istring &new_mask);
  const istring &ip_address() const;
  void ip_address(const istring &new_address);

  bool valid() const { return _valid; }
    // returns whether the object has recalculated its mask information yet
    // or not.  the object should always be valid until the mask or address
    // are changed.  once the two range methods are called, the object should 
    // be valid afterwards.

private:
  bool _valid;  // is this object valid yet (has calculate been called)?
  istring *_subnet_mask;  // the mask used for the subnets in question.
  istring *_ip_address;  // internet address of an example host on the subnet.
  istring *_low_end;  // lower bound and
  istring *_high_end;   // upper bound of the subnet.

  void calculate();
    // performs the main action of determining the lower and upper bounds
    // of the subnet's range.
};

#endif

---