FBB::Cidr - Compares IP4 addresses to CIDR specifications
Linking option: -lbobcat
Objects of the class Cidr
can be used for testing whether IP4 Internet
addresses belong to address ranges defined by Classless Inter-Domain Routing
(CIDR) address block specifications. CIDR blocks are specified as
are the four octets of a dotted decimal
IP4 address specification (e.g., 18.104.22.168) and m
is a mask-size
(ranging from 0 to 32) defining the number of most significant bits to remain
as-is. The CIDR specification 22.214.171.124/16 defines a class B network, with
addresses ranging from 126.96.36.199 to 188.8.131.52.
The mask size does not have to be a multiple of 8. E.g., when specifying
184.108.40.206/5 only the most significant 5 bits of the first octed are fixed,
resulting in an address range ranging from 220.127.116.11 to 18.104.22.168.
CIDR specifications passed to a Cidr
object must be of the form
. If the mask is not specified a mask-size
of 32 is used, effectively defining an address range of only one address. Mask
values of 0 are ignored. Mask values of 0 are ignored by Cidr
When specifying CIDRs on a stream, empty lines and comment lines (having a
hash-character (#) as their first non-blank character) are ignored. Non-empty
lines must start with a CIDR specification, and the Cidr
ignore all information on a line trailing a CIDR specification.
All constructors, members, operators and manipulators, mentioned in this
man-page, are defined in the namespace FBB
- Cidr(std::string const &cidrPattern):
The Cidr object is initialized with a single CIDR specification.
- Cidr(std::istream &cidrStream):
The Cidr object is initialized with CIDR specifications read from the
std::istream cidrStream. The default, copy and move constructors
The copy and move assignment operators are available.
The return valuess of the accessors (i.e., the const
members) are only
defined following a successful match (see below, the match
- std::string const &address() const:
returns the address matching a CIDR.
- std::string cidr() const:
returns the CIDR containing a specified address.
- std::string first() const:
returns the first address of the range of addresses defined by the CIDR
- std::string last() const:
returns the last address of the range of addresses defined by the CIDR
specification. Note that first, last do not define an iterator
range. The address returned by last still belongs to the
- bool match(std::istream &in):
The value true is returned when an IP4 address found in the lines of
in belongs to a CIDR range inspected by the Cidr object. The
match function returns true at the first matching address.
E.g., if a line contains the text
This is address 22.214.171.124 and this is 126.96.36.199
and the CIDR specifications
were provided to the Cidr object, then the object will report a match
- As soon as a match is found match returns
true. If none of the addresses found in the lines of in
matches any of the object’s CIDR specifications, false is
- std::string mask() const:
returns the mask used by the CIDR specification.
- bool match(std::string const &line):
The value true is returned when an IP4 address found in line
belongs to a CIDR range inspected by the Cidr object. The
match function returns true at the first matching
- If none of the addresses found in line matches any
of the object’s CIDR specifications, false is returned.
- void setCidr(std::istream &cidrStream):
A new set of CIDR specification is loaded into the Cidr object,
reading the specifications from cidrStream.
- void setCidr(std::string const &cidrPattern):
A new CIDR specification is loaded into the Cidr object, using the
specification found in cidrPattern. The Cidr object is
initialized with a single CIDR specification which must be of the form
a.b.c.d or a.b.c.d/m. If the mask is not specified a
mask-size of 32 is used, effectively defining an address range of only one
address. Mask values of 0 are ignored.
- size_t dotted2binary(std::string const &dotted):
Converts "a.b.c.d" to a 32-bits value
- std::string binary2dotted(size_t binary):
Converts a 32-bits value to a dotted decimal IP4 address
using namespace std;
using namespace FBB;
int main(int argc, char **argv)
Spec spec = CIN;
if (argc > 1)
Errno::open(in, argv); // file containing cidr-specs
spec = FILE;
if (spec == CIN)
cout << "Specify cidr (empty to quit): ";
if (!getline(cin, cidrSpec) || cidrSpec.empty())
spec = NONE;
cout << "Specify address to test (empty to " <<
(spec == CIN ? "respec. CIDR" : "quit") << "): ";
if (!getline(cin, address) || address.empty())
cout << "Address " << address << " not in ";
if (spec == CIN)
cout << cidrSpec << ’\n’;
cout << "specifications in " << argv << ’\n’;
cout << "Address " << address << " in " << cidr.cidr() <<
"Lowest address: " << cidr.first() << "\n"
"Highest address: " << cidr.last() << "\n"
"CIDR mask: " << cidr.mask() << "\n"
"Address: " << cidr.address() << ’\n’;
catch (Errno const &err)
cout << "Oops... " << err.why() << "\n"
- defines the class interface
Members of Cidr
use static data. The current implementation of
is therefore not thread-safe.
- bobcat_3.01.00-x.dsc: detached signature;
- bobcat_3.01.00-x.tar.gz: source archive;
- bobcat_3.01.00-x_i386.changes: change log;
- libbobcat1_3.01.00-x_*.deb: debian package holding
- libbobcat1-dev_3.01.00-x_*.deb: debian package
holding the libraries, headers and manual pages;
- http://sourceforge.net/projects/bobcat: public
Bobcat is an acronym of `Brokken’s Own Base Classes And Templates’.
This is free software, distributed under the terms of the GNU General Public
Frank B. Brokken ( firstname.lastname@example.org