Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Cross-platform public domain foundation library in C providing basic support data types and functions to write applications and games in a platform-independent fashion.
C Python C++ Objective-C Other

README.md

Foundation Library - Public Domain

This library provides a cross-platform foundation library in C providing basic support data types and functions to write applications and games in a platform-independent fashion. It provides:

  • Abstractions and unification of basic data types
  • Pluggable memory management
  • Threads and synchronization
  • Atomic operations
  • Timing and profiling
  • Object lifetime management
  • Events processing
  • File system access
  • Dynamic library loading
  • Process spawning
  • Logging, error reporting and asserts
  • String handling in UTF-8 and UTF-16
  • Murmur hasing and statically hashed strings
  • Math support for 32 and 64 bit floats
  • Configuration repository with config file I/O
  • Application, environment and system queries and control
  • Regular expressions
  • Crash utilities (SEH, signals)

It is written with the following API design principles in mind:

  • Consistent. All functions, parameters and types should follow a well defined pattern in order to make it easy to remember how function names are constructed and how to pass the expected parameters.
  • Orthogonal. A function should not have any side effects, and there should be only one way to perform an operation in the system.
  • Specialized. A function in an API should perform a single task. Functions should not do completely different unrelated tasks or change behaviour depending on the contents of the variables passed in.
  • Compact. The API needs to be compact, meaning the user can use it without using a manual. Note though that "compact" does not mean "small". A consistent naming scheme makes the API easier to use and remember.
  • Contained. Third party dependencies are kept to an absolute minimum and prefer to use primitive or well-defined data types.

Platforms and architectures currently supported:

  • Windows (x86, x86-64), Vista or later
  • MacOS X (x86-64), 10.7+
  • Linux (x86, x86-64, PPC, ARM)
  • FreeBSD (x86, x86-64, PPC, ARM)
  • iOS (ARM7, ARM7s, ARM64), 6.0+
  • Android (ARM6, ARM7, ARM8-AARCH64, x86, x86-64, MIPS, MIPS64)
  • Raspberry Pi (ARM6)
  • PNaCl

The latest source code maintained by Rampant Pixels is always available at

https://github.com/rampantpixels/foundation_lib

Pre-generated documentation in HTML format for the latest release can be found at

http://rampantpixels.github.io/foundation_lib/doc

Master branch is used for stable releases. Development is done in feature branches from the develop branch

https://github.com/rampantpixels/foundation_lib/tree/develop

Cross-platform build system uses Ninja

http://martine.github.io/ninja

The PNaCl build of the latest release can be tested at

http://www.rampantpixels.com/foundation_lib/pnacl/

Test suite coverage report:

Coverage Status

This library is put in the public domain; you can redistribute it and/or modify it without any restrictions.

Something went wrong with that request. Please try again.