Capabilities

Jede Ebene als
verifizierbares Verhalten

Von der Zielversionswahl über vordefinierte Makros und Diagnosen bis hin zu PCH und echten Projekten: CrucibleCpp arbeitet nicht mit „müsste passen“, sondern mit einer wiederholbaren Testkette.

A

Zielversion und Profil

Ein Präprozessor, drei Ziel-GCC-Versionen. Sie wählen die Version – und erhalten genau deren vordefinierte Makros, die__has_* Daten und Include-Suchpfade.

  • --gcc-version=13|14|15
  • --gcc D:\path\to\g++.exe
  • Automatische PATH-Erkennung, standardmäßig die höchste unterstützte Version
  • GCC 13.3 / 14.3 / 15.2 profile
  • C++11 / C++14 / C++17 / C++20
B

Diagnosesystem

Ein Diagnoseformat für echte Build-Systeme. Es enthält Quellzeile, Caret, Include-Trace und Warning-Option – nicht nur einen Fehlerstring.

  • GCC-typische severity / option / caret
  • -Werror, -Wno-..., -Werror=...
  • #pragma GCC diagnostic push/pop
  • #pragma GCC system_header
  • -Wsystem-headers und System-Header-Unterdrückung
C

Makros und Vorverarbeitungssemantik

Objektmakros, Funktionsmakros, leere Argumente, variadische Makros, Stringifizierung, Token-Pasting sowie die Komma-Entfernungs-Erweiterung von GCC.

  • # und ##
  • __VA_OPT__(C++20)
  • , ## __VA_ARGS__
  • defined / __has_include
  • Macro-Trace und Include-Graph-Analyse als JSON
D

UCN und #embed

Universal Character Names wirken an Bezeichnern und an der Verkettung mit;#embed bettet Binärressourcen gemäß GCC-Semantik ein.

  • \uXXXX / \UXXXXXXXX
  • UCNs aus Backslash-Zeilenumbrüchen
  • # / ## behalten die UCN-Schreibweise bei
  • #embed + limit
  • prefix / suffix / if_empty
  • gnu::offset und __has_embed
E

PCH und Cache

PCH-Strategie und Cache stehen für GCC 13/14/15 gleichermaßen zur Verfügung. Der Cache parst GCC-PCH nicht direkt, sondern validiert, registriert, invalidiert und verfolgt externe .gch.

  • --pch=ignore|warn|error|report
  • CMake-PCH-Layout mit erzwungenem Include
  • Isolation von Compiler-Pfad, Version und Hash
  • Atomares Schreiben, Verzeichnissperren, Bereinigung nach Größe und Alter
  • JSON-Statistik zu Trefferquote / stale / corrupt
F

Reproduzierbare Tests

Drei GCC-Toolchains, zwei Differential-Korpora und echte Projekte validieren die Ausgabe gemeinsam – nicht nur, ob „die Vorverarbeitung erfolgreich war“.

  • GCC 15 / 14 / 13: jeweils 65/65 CTest
  • differential corpus 13/13
  • realworld corpus 3/3
  • CrucibleCpp .i → Ziel-GCC → EXE → ausführen
  • GCC g++.dg/cpp Test-Suite wird auf Regressionen geprüft
Positioning

Ersetzt wird der Vorverarbeitungsschritt, nicht der Compiler

CrucibleCpp erzeugt keinen Code, optimiert nicht und parst kein binäres GCC-PCH. Es verwandelt Quelldateien ausschließlich in deterministische .i, und reicht Diagnosen, Abhängigkeiten und analysierbare Informationen an das Build-System weiter.