ossp-pkg/var/README
_ ___ ____ ____ ____
|_|_ _ / _ \/ ___/ ___|| _ \ __ ____ _ _ __
_|_||_| | | | \___ \___ \| |_) | \ \ / / _` | '__|
|_||_|_| | |_| |___) |__) | __/ \ V / (_| | |
|_|_|_| \___/|____/____/|_| \_/ \__,_|_|
OSSP var - Variable Expansion
Version 1.1.3 (02-Oct-2005)
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-2005 Ralf S. Engelschall <rse@engelschall.com>
Copyright (c) 2001-2005 The OSSP Project <http://www.ossp.org/>
Copyright (c) 2001-2005 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/
