Ressourcen-Einbindung (seit C++26)

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

C++ Sprache

Allgemeine Themen
Präprozessor Kommentare	Schlüsselwörter Escape-Sequenzen
Kontrollfluss
Bedingte Ausführungsaussagen
if	switch
Iterationsanweisungen (Schleifen)
for Bereichs-for (C++11)	while do-while
Sprunganweisungen
continue - break	goto - return
Funktionen
Funktionsdeklaration
Lambda-Funktionsausdruck
inline-Spezifizierer
Dynamische Ausnahmespezifikationen (bis C++17*)
noexcept-Spezifizierer (C++11)
Ausnahmen
throw-Ausdruck try-Block	catch-Handler
Namensräume
Namensdeklaration	Namensaliase
Typen
Fundamentale Typen Aufzählungstypen Funktionstypen	Klassen-/Strukturtypen Union-Typen
Spezifizierer
const/volatile decltype (C++11) auto (C++11)	constexpr (C++11) consteval (C++20) constinit (C++20)
Speicherdauer-Spezifizierer
Initialisierung
Standardinitialisierung Wertinitialisierung Nullinitialisierung Kopierinitialisierung Direkte Initialisierung	Aggregatinitialisierung Listeninitialisierung (C++11)   Konstante Initialisierung Referenzinitialisierung

Ausdrücke
Wertkategorien Reihenfolge der Auswertung	Operatoren Operatorrangfolge
Alternative Darstellungen
Literale
Boolesch - Ganzzahl - Gleitkommazahl
Zeichen - String - nullptr (C++11)
Benutzerdefinierte (C++11)
Dienstprogramme
Attribute (C++11)
Typen
typedef-Deklaration
Typalias-Deklaration (C++11)
Umwandlungen
Implizite Konvertierungen static_cast const_cast	Explizite Konvertierungen dynamic_cast reinterpret_cast
Speicherzuweisung
new-Ausdruck	delete-Ausdruck
Klassen
Klassendeklaration Konstruktoren this-Zeiger	Zugriffsspezifizierer friend-Spezifizierer
Klassenspezifische Funktionseigenschaften
Virtuelle Funktion override-Spezifizierer (C++11)   final-Spezifizierer (C++11)	explicit (C++11) static
Spezielle Member-Funktionen
Standardkonstruktor Kopierkonstruktor Move-Konstruktor (C++11)	Kopierzuweisung Move-Zuweisung (C++11) Destruktor
Templates
Klassenschablone Funktionsschablone	Schablonenspezialisierung Parameter-Pakete (C++11)
Sonstiges
Inline-Assembler	Geschichte von C++

 

Präprozessor

#if#ifdef#ifndef#else#elif#elifdef#elifndef#endif (C++23)(C++23)

#define#undef#,## Operatoren

#include__has_include (C++17)

#error#warning (C++23)

#pragma_Pragma (C++11)

#line

#embed (C++26)

 

#embed ist eine Präprozessor-Direktive zum Einbinden von Ressourcen, wobei eine Ressource als eine Datenquelle definiert ist, die aus der Übersetzungs-Umgebung zugänglich ist.

Syntax

#embed < resource > pp-tokens (optional) \n *	(1)
#embed " resource " pp-tokens (optional) \n *	(2)
#embed pp-tokens\n *	(3)
__has_embed ( pp-balanced-token-seq )	(4)

1) Sucht nach einer eindeutig identifizierten resource.

2) Sucht nach einer benannten resource. Fällt auf (1) zurück, als ob stattdessen spitze Klammern anstelle von Anführungszeichen verwendet worden wären.

1-2) Ersetzt die Direktive durch eine kommagetrennte Liste von Ganzzahlen, die den Daten der Ressource entsprechen.

3) Wenn weder (1) noch (2) zutreffen, wird pp-tokens einer Makroersetzung unterzogen. Die Direktive nach der Ersetzung wird erneut versucht, mit (1) oder (2) abzugleichen.

resource	-	Eine einzubettende Ressource
pp-tokens	-	Positive Anzahl von Präprozessor-Tokens
pp-balanced-token-seq	-

Erklärung

1) Eine Suche findet in einer Reihe von implementierungsdefinierten Orten statt. Wie die Orte spezifiziert oder die Ressource identifiziert wird, ist implementierungsdefiniert.

2) Eine Suche findet auf eine implementierungsdefinierte Weise statt. Ein Fallback folgt, wenn diese Suche nicht unterstützt wird oder fehlschlägt.

Beispiel

Angenommen, die Datei word.txt enthält ein einziges Wort: worlds.

• limit(5) begrenzt das Einbetten auf 5 Zeichen (bettet effektiv das Wort world ohne den ersten Buchstaben s ein).
• prefix(0x2C, 0x20, ) stellt , ​ dem String s voran: 0x2C ist der Hex-Code von , und 0x20 ist der Hex-Code von ​ ​.
• suffix(, 0x21) hängt !​ an den String s an: 0x21 ist der Hex-Code von !.

Führen Sie diesen Code aus

#include <string>
#include <print>
 
int main()
{
    std::string s
    {
        #embed "word.txt" prefix(0x2C, 0x20, ) suffix(, 0x21) limit(5)
    };
 
    std::println("Hello{}", s);
}

Mögliche Ausgabe

Hello, world!

Referenzen

• C++26 Standard (ISO/IEC 14882:2026)

• 15.4 Ressourcen-Einbindung [cpp.embed]

Siehe auch

• Einbeziehung von Quelldateien

C-Dokumentation für Binäre Ressourcen-Einbindung (seit C23)