### Navigation

- index
- modules |
- next |
- previous |
- Pure Language and Library Documentation »

# pure-stllib

Version 0.2, June 03, 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
- Installation
- Usage
- Documentation
- Changes

## 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.2 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.2.tar.gz.

To install pure-stllib-0.2 (on Linux), extract the source code (e.g., tar -xzf pure-stllib-0.2.tar.gz), cd to the pure-stllib-0.2 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.

### Navigation

- index
- modules |
- next |
- previous |
- Pure Language and Library Documentation »