_        ___  ____ ____  ____
  |_|_ _   / _ \/ ___/ ___||  _ \  __   ____ _ _ __ 
  _|_||_| | | | \___ \___ \| |_) | \ \ / / _` | '__|
 |_||_|_| | |_| |___) |__) |  __/   \ V / (_| | |
  |_|_|_|  \___/|____/____/|_|       \_/ \__,_|_|

  OSSP var - Variable Expansion
  Version 1.1.2 (31-Oct-2004)

  ABSTRACT

  OSSP var is a flexible, full-featured and fast variable construct
  expansion library. It supports a configurable variable construct
  syntax very similar to the style found in many scripting languages
  (like @name, ${name}, $(name), etc.) and provides both simple scalar
  (${name}) and array (${name[index]}) expansion, plus optionally one or
  more post-operations on the expanded value (${name:op:op...}).

  The supported post-operations are length determination, case
  conversion, defaults, positive and negative alternatives, sub-strings,
  regular expression based substitutions, character translations, and
  padding. Additionally, a meta-construct plus arithmetic expressions
  for index and range calculations allow (even nested) iterations
  over array variable expansions (..[..${name[#+1]}..]..). The actual
  variable value lookup is performed through a callback function, so
  OSSP var can expand arbitrary values.

  COPYRIGHT AND LICENSE

  Copyright (c) 2001-2004 Ralf S. Engelschall <rse@engelschall.com>
  Copyright (c) 2001-2004 The OSSP Project <http://www.ossp.org/>
  Copyright (c) 2001-2004 Cable & Wireless <http://www.cw.com/>

  This file is part of OSSP var, a variable expansion
  library which can be found at http://www.ossp.org/pkg/lib/var/.

  Permission to use, copy, modify, and distribute this software for
  any purpose with or without fee is hereby granted, provided that
  the above copyright notice and this permission notice appear in all
  copies.

  THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
  WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  IN NO EVENT SHALL THE AUTHORS AND COPYRIGHT HOLDERS AND THEIR
  CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  SUCH DAMAGE.

  HOME AND DOCUMENTATION

  The documentation and latest release can be found on

  o http://www.ossp.org/pkg/lib/var/
  o  ftp://ftp.ossp.org/pkg/lib/var/