---

ixlib Documentation

Welcome to ixlib.

© 1996-2001 by Andreas Klöckner (ak@ixion.net) and Hardy Kahl (hk@ixion.net).

Permission to use, copy, modify, and distribute this software and its documentation under the terms of the GNU Library General Public License is hereby granted. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty. See the file COPYING included in the distribution for the exact details.

Introduction

ixlib is a C++ tools library based upon the Standard Template Library. It arose out of several classes and components that we wrote over the years and finally decided to bundle together in one package. It has however grown to be much more than a mixed bag of stuff agglomerated over the years. It contains a wide variety of functionality that is all hand-implemented in ixlib. ixlib does not have any external library dependencies besides the Standard Template Library, which it tries to complement in several ways.

ixlib makes heavy use of ANSI C++ and its features, that is, it requires a fairly new compiler. Any version of gcc above 2.95 will do. One of the features ixlib uses is namespaces, in order to minimize namespace interference with client programs. All of ixlib is hidden inside the namespace "ixion", the JavaScript interpreter further hides inside "ixion::javascript".

ixlib is gettext-integrated, currently English and German translations are available. (as of March 2001)

ixlib's homepage is at http://ixlib.sourceforge.net.

Functionality index

ixlib functionality can be roughly subdivided into the following areas:

Useful little helpers

• types with guaranteed sizes in bits, see ixlib_base.hh.
• versatile int <-> string conversions, see ixlib_numconv.hh.
• command line parsing, see ixion::command_line.
• internationalization, call ixlibInitI18n() to enable.
• random number generators, see ixion::float_random and ixion::int_random.
• some string crunching tools, see ixlib_string.hh.
• some bit crunching tools, see ixlib_numeric.hh.

Foundation library-type functionality

• an exception handling framework, with its base at ixion::base_exception.
• garbage collection, look at ixion::ref.
• automatic array management, look at ixion::array and its subclasses.
• a ring queue container, see ixion::ring_queue.

Mathematical components

• matrices, see ixion::matrix.

Geometrical components

• planar geometry, look at ixion::coord_vector, ixion::rectangle, ixion::region.
• polygons, look at ixion::polygon.
• rasterization primitives, see namespace ixion::drawing_functions

Bigger building blocks

• a javascript interpreter, look at class ixion::javascript::interpreter. Parts of the standard JavaScript library have also been implemented, see ixion::javascript::addStandardLibrary().
• regular expressions, see ixion::regex_string for a Perl-compatible regex parser and matcher, and ixion::regex for a more general matching component.
• xml parsing (non-DTD), see ixion::xml_file.

---