Startseite › Entwickler-Tools › Datei in C-Array

Datei in C-Array

Wandle jede Datei in ein C- oder C++-Byte-Array um, das du direkt in Firmware oder eine Anwendung kompilieren kannst, genau wie mit xxd -i. Wähle Hex oder Dezimal, die Bytes pro Zeile und den Elementtyp und füge const, static, PROGMEM, Ausrichtung oder einen Header-Guard hinzu.

Zuletzt aktualisiert:

Offset und Anzahl akzeptieren Dezimal- oder 0x-Hexwerte.

Anzeige
Anzeige

Anleitung: Datei in C-Array

  1. Zieh eine Datei hierher (oder wechsle zum Tab Text und gib eine Zeichenkette ein).
  2. Prüfe den Variablennamen; er wird aus dem Dateinamen gebildet, wobei Punkte, Bindestriche und Leerzeichen zu Unterstrichen werden.
  3. Wähle das Format: Elementtyp, Hex- oder Dezimalwerte und Bytes pro Zeile.
  4. Füge Qualifizierer hinzu wie const, static oder PROGMEM und wähle, wie die Länge exportiert wird.
  5. Kopiere den Code oder lade die .h-Datei herunter und binde sie in dein Projekt ein.

Beispielausgabe

Für eine 23 Byte große Textdatei namens hello.txt erzeugen die Standardeinstellungen Folgendes (deaktiviere const, um genau die Ausgabe von xxd -i zu erhalten):

/* hello.txt (23 bytes) */
const unsigned char hello_txt[] = {
  0x48, 0x65, 0x6c, 0x6c, 0x6f, 0x2c, 0x20, 0x65, 0x6d, 0x62, 0x65, 0x64,
  0x64, 0x65, 0x64, 0x20, 0x77, 0x6f, 0x72, 0x6c, 0x64, 0x21, 0x0a
};
const unsigned int hello_txt_len = 23;

Verwende es wie jedes andere Array: fwrite(hello_txt, 1, hello_txt_len, f); oder, bei einem PROGMEM-Array auf AVR, pgm_read_byte(&hello_txt[i]).

Optionen im Vergleich

OptionWas sie hinzufügtWann man sie nutzt
constconst unsigned char name[]Fast immer: Schreibgeschützte Daten können im Flash oder in einem Read-only-Bereich bleiben.
staticstatic-BindungWenn der Header in mehreren .c-Dateien eingebunden wird, um Fehler durch doppelte Symbole zu vermeiden.
PROGMEMPROGMEM + #include <avr/pgmspace.h>AVR-Boards (Uno, Nano, Mega), um Daten aus dem SRAM herauszuhalten.
Auf 4 Bytes ausrichten__attribute__((aligned(4))) oder alignas(4)DMA-Puffer oder wenn die Bytes als 32-Bit-Wörter gelesen werden.
Header-Guard#ifndef NAME_H … #endifWenn die Datei als .h-Header gespeichert und eingebunden wird.
0x00-TerminatorEin zusätzliches NullbyteEinbetten von Text, der als C-String verwendet wird.
C++ std::arrayconstexpr std::array<T, N>Moderner C++-Code, der die Größe im Typ und Zugriff zur Kompilierzeit möchte.

Alternativen zu einem Byte-Array

  • C23 #embed: Neuere Compiler (GCC 15, Clang 19) unterstützen #embed "file.bin" in einem Initialisierer, das die Datei zur Kompilierzeit liest.
  • Linker-Objekte: ld -r -b binary file.bin -o file.o oder objcopy machen aus einer Datei ein Objekt mit den Symbolen _binary_file_bin_start und _end.
  • Byte-Arrays (dieses Tool) bleiben die portabelste Wahl: Sie funktionieren mit jedem Compiler, jeder IDE und jeder Mikrocontroller-Toolchain und erfordern keine Änderungen am Build-System.

Häufige Fragen

Ist die Ausgabe dieselbe wie bei xxd -i?

Ja, abgesehen von einem einzeiligen Kommentar mit dem Dateinamen. Deaktiviere const und behalte die übrigen Standardwerte (C-Array, unsigned char, Hex in Kleinbuchstaben, 12 Bytes pro Zeile, Länge als unsigned int), dann entspricht das Layout xxd -i: ein nach der Datei benanntes unsigned-char-Array, Einrückung mit zwei Leerzeichen und eine unsigned-int-Variable name_len mit der Byteanzahl.

Wie wird der Variablenname aus dem Dateinamen gebildet?

Jedes Zeichen, das kein Buchstabe, keine Ziffer und kein Unterstrich ist, wird zu einem Unterstrich, aus logo.png wird also logo_png und aus font-16px.bin wird font_16px_bin. Ein Name, der mit einer Ziffer beginnen würde, erhält das Präfix data_, weil C-Bezeichner nicht mit einer Zahl beginnen dürfen. Du kannst auch jeden anderen Namen eingeben.

Was macht PROGMEM?

Auf AVR-Mikrocontrollern wie dem Arduino Uno werden const-Daten beim Start trotzdem in den kleinen SRAM kopiert. Mit PROGMEM (aus avr/pgmspace.h) bleibt das Array stattdessen im Flash-Speicher, und du liest es mit pgm_read_byte(). Auf ESP32, ARM und den meisten anderen Chips hält schon const allein die Daten im Flash.

Soll ich unsigned char oder char verwenden?

Verwende unsigned char oder uint8_t für Binärdaten. Einfaches char ist bei den meisten Compilern vorzeichenbehaftet, daher passen Werte über 0x7F nicht hinein, was in C++ bei der Initialisierung mit geschweiften Klammern ein Narrowing-Fehler und in C eine Warnung ist. Wählst du char oder signed char, werden diese Bytes mit einem expliziten Cast geschrieben.

Warum einen 0x00-Terminator anhängen?

Ein angehängtes Nullbyte erlaubt es, eine eingebettete Textdatei (HTML, JSON, einen Shader oder ein Zertifikat) direkt als C-String zu verwenden. Der Längenwert enthält dann dieses zusätzliche Byte.

Wie groß darf eine Datei sein?

Dateien bis 32 MB können im Browser umgewandelt werden. Die Textausgabe ist etwa sechsmal so groß wie die Datei, daher werden sehr große Ausgaben auf dem Bildschirm nur teilweise angezeigt, aber Kopieren und Herunterladen liefern immer den vollständigen Header.

Wird meine Datei hochgeladen?

Nein. Die Datei wird mit der File API des Browsers gelesen, und der Header wird auf deinem Gerät erzeugt.

Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?

Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.

Ähnliche Tools

Alle Daten- & Dateiformat-Konverter ansehen →