libphorward

The libphorward is a generic C/C++ library and toolbox, serving platform-independent utilities for different purposes.

Data structures

parray - Dynamically managed arrays & stacks
pccl - Character-classes
plex - Lexical analysis
plist - Linked lists, hash-tables, queues & stacks
pregex - Regular expressions

Generic helpers

DEBUG-facilities - Logging, tracing and run-time analysis
pgetopt - Command-line options interpreter
pstr, pwcs - Enhanced string operations

Command-line tools

pdoc - C source code documentation tool
pinclude - Generate big files from various smaller ones
plex - Lexical analyzer generator and interpreter
pproto - C function prototype generator
pregex - Regular expressions match/find/split/replace
ptest - C program test facilities

Documentation

A recently updated, full documentation can be found here, and is also locally available after installation.

Building

Building phorward is simple as every GNU-style open source program. Extract the downloaded release tarball or clone the source repository into a directory of your choice.

Then, run

./configure
make
make install

And you're ready to go!

Alternative development build

Alternatively, there is also a simpler method for setting up a local build system for development and testing purposes.

To do so, type

make -f Makefile.gnu make_install
make

This locally compiles the library or parts of it, and is ideal for development purposes.

Stand-alone copy

The entire library including its tools can be made available in one target directory by using the script ./standalone.sh.

This makes stand-alone integration of the entire library into other projects possible without a previous installation or porting, and easier maintainable packages.

The generated stand-alone package contains a Makefile and can directly be built.

Credits

libphorward is developed and maintained by Jan Max Meyer, Phorward Software Technologies.

Contributions by Heavenfighter and AGS.

License

You may use, modify and distribute this software under the terms and conditions of the MIT license. The full license terms can be obtained from the file LICENSE.

phorward / libphorward

readme