pure-stllib

Version 0.4, November 05, 2012

Peter Summerland <p.summerland@gmail.com>

pure-stllib is an “umbrella” package that contains a pair of Pure addons, pure-stlvec and pure-stlmap. These addons provide Pure interfaces to a selection of containers provided by the C++ Standard Library, specialized to hold pointers to arbitrary Pure expressions. pure-stlvec is a Pure interface to C++’s vector and the STL algorithms that act on them. pure-stlmap is an interface to six (of the eight) of C++’s associative containers: map, set, multimap, multiset, unordered_map and unordered_set.

Copying

Copyright (c) 2011-2012 by Peter Summerland <p.summerland@gmail.com>.

All rights reserved.

pure-stllib is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

pure-stllib is distributed under a BSD-style license, see the COPYING file for details.

Installation

pure-stllib-0.4 requires at least Pure 0.50. The latest version of Pure is available at http://code.google.com/p/pure-lang/downloads/list.

The latest version of the source code for pure-stllib can be downloaded from http://pure-lang.googlecode.com/files/pure-stllib-0.4.tar.gz.

To install pure-stllib-0.4 (on Linux), extract the source code (e.g., tar -xzf pure-stllib-0.4.tar.gz), cd to the pure-stllib-0.4 directory, and run make. After this you can (and should) also run make check to run a few unit tests to make sure that pure-stlvec and pure-stlmap work properly on your system. If make check works, run sudo make install to install pure-stlvec and pure-stlmap. Run sudo make uninstall to remove them.

make tries to guess your Pure installation directory and platform-specific setup. If it gets this wrong, you can set some variables manually. In particular, make install prefix=/usr sets the installation prefix. Please see the Makefile for details.

Usage

pure-stlvec provides functions that act on a single mutable container, stlvec, which is a wrapper around C++’s vector, specialized to hold Pure expressions. It also provides functions that correspond to C++’s STL algorithms specialized to act on stlvecs.

pure-stlmap provides functions that act on six mutable containers, “stlmap”, “stlset”, “stlmmap”, “stlmset”, “stlhmap” and “stlhset”, that are thin wrappers around the corresponding associative containers provided by C++, map, set, multimap, multiset, unordered_map and unordered_set, specialized to hold Pure expressions.

The functions provided by pure-stlvec and pure-stlmap are made available by importing one or more of the following modules.

stlvec - support for stlvecs

stlvec::algorithms - STL algorithms specialized to act on stlvecs

stlmap - support for stlmap and stlset

stlmmap - support for stlmmap and stlmset

stlhmap - support for stlhmap and stlhset

Documentation

Please see the documentation for pure-stlvec and pure-stlmap.

For the impatient, the functions that act on containers provided by the stlmap, stlmmap, stlhmap and stlvec modules are summarized in a rudimentary cheatsheet, pure-stllib-cheatsheet.pdf, which can be found in the pure-stllib/doc directory.

Changes

Version 0.1 - Bundle pure-stlvec-0.3 and pure-stlmap-0.1.

Version 0.2 - Bundle pure-stlvec-0.3 and pure-stlmap-0.2.

Version 0.3 - Bundle pure-stlvec-0.4 and pure-stlmap-0.3.

Table Of Contents

Previous topic

pure-stldict

Next topic

pure-stlmap

This Page