notSTL: Cross Platform & Compiler STL

Plain old STL, configurable, measurable.

Table of Contents

• Overview
• Requirements
• Getting Started

Overview

The aim of this project is to create a cross platform STL that is configurable by users and easily measurable for profiling. The decisions that are generally left to compiler vendors shall be configurable via constants and switches.

There often exists an implementation of STL that is faster if one or two things were changed in the API, this project aims to make that possible and configurable, which might make it hard to maintain full standard compliance.

Requirements

Common:

• CMake >= 3.4
• bash (On Windows use MinGW installed via Git for Windows)

Windows:

• Visual Studio

Linux:

• GCC or Clang
• Visual Studio Code (Optional, Requires GCC + GDB)
• VSCode C++ Extension (Optional, Required with VSCode)

Getting Started

To build the project as is run:

./create.sh

This script detects which OS you are running and runs the default CMake project generate command. It supports the following flags:

• -h|--help to print help
• -f|--folder=<folder> name of the folder to store build files. Default: build
• -G="Generator Name" for custom generator. Default: "Visual Studio 14 Win64" or "Unix Makefiles"
• -m|--make=<extra CMake params> Eg: -m='-DVAR_SETUP=1 -DVAR2_SETUP=0

Linux only:

• -b|--build=<build type> CMake build type. Default: Debug
• -c|--clang Uses the Clang compiler instead of GCC. Default: Don't use Clang
• -v|--vscode Skip setting up VSCode configs. Default: Setup VSCode configs

Note: Using Clang will still show CMake as setting up GCC but it will definitely be using Clang