Foundation

Table of Contents

• Dependencies
• Features
  • Classes
  • Macros
  • Type Traits
  • Utilities
• Status
• Description
  • Function
  • Deferred
  • OpaqueObject
  • UniqueHandle
• Blog
• Roadmap
• Statistics

🟩 Primitive types, asserts, compiler macros, Function, Span, Result

SaneCppFoundation.h is a library that provides many fundamental type definitions and types widely used by other libraries.
As this is included and needed by almost every other library, it tries to keep bloat to the bare minimum.
Detailed documentation is in the Foundation topic.

Dependencies

• Dependencies: (none)
• All dependencies: (none)

Features

Classes

Class	Description
SC::Span	Non-owning contiguous view over caller-provided memory
SC::StringSpan	Non-owning string view with explicit encoding
SC::StringPath	Non-owning path string view
SC::Result	Small success/error result type for APIs without exceptions
SC::Function	Fixed-storage callable wrapper
SC::Deferred	Scope-exit helper for explicit cleanup
SC::OpaqueObject	Fixed-size opaque storage for static PIMPL
SC::UniqueHandle	Move-only RAII wrapper for handles

Macros

• Compiler Macros:

Compiler Macros Preprocessor macros to detect compiler and platform features.

Type Traits

• Type traits: small compile-time helpers used by Foundation and embedded Common fragments

Utilities

Class	Description
SC::Assert	Foundation-owned assertion provider
SC::AlignedStorage	Fixed-size aligned storage for hiding implementation details

Status

🟩 Usable
The library is very simple it it has what is needed so far by the other libraries.

Description

There is an hard rule in the library Principles not to include system and compiler headers in public headers.
Foundation provides all primitive types to be used in headers and classes like SC::UniqueHandle, SC::OpaqueObject, SC::AlignedStorage to encourage static PIMPL in order to hide platform specific implementation details everywhere.

Function

Fixed-storage callable wrapper used when APIs need callbacks without dynamic allocations.

Deferred

Scope-exit helper used to run explicit cleanup code when leaving a scope.

OpaqueObject

Fixed-size opaque storage used to hide private implementation details in public headers.

UniqueHandle

Move-only RAII wrapper used to close or release handles deterministically.

Blog

Some relevant blog posts are:

• January 2025 Update
• June 2025 Update
• July 2025 Update
• May 2026 Update

Roadmap

🟦 Complete Features:

• Things will be added as needed

Statistics

Type	Lines Of Code	Comments	Sum
Headers	1103	684	1787
Sources	362	72	434
Sum	1465	756	2221