Printf-Format escapen

Formatstrings der printf-Familie behandeln ein einzelnes Prozentzeichen als Beginn einer Konversionsspezifikation, sodass freier Text mit einem Prozent—Fortschrittslabel, Währungshinweise, Log-Vorlagen—abstürzt, falsch geparst wird oder die falschen Argumente verbraucht, sofern nicht jedes literale Prozent zu %% verdoppelt wird. Gleichzeitig liegen Formatkörper oft in Quellcode-Stringliteralen oder Konfigurationsdateien, in denen Zeilenumbrüche, Tabs und Backslashes als Backslash-Escapes geschrieben werden müssen. Dieser Printf-Format-Escaper wandelt Klartext in einen sicheren Formatkörper um, indem er jedes Prozent verdoppelt und Steuerzeichen sowie Backslashes als \\ , \n, \r, \t oder \xHH umschreibt, und kehrt dieselbe Abbildung um, wenn Sie die Originalzeichen zurückbenötigen.

So funktionieren Prozentverdopplung und Backslash-Escapes in printf

In C-printf, in C++-iostreams mit printf-ähnlichen Formatstrings, in Pythons alter %-Formatierung und in vielen Logging-Bibliotheken beginnt ein Prozentzeichen eine Konversion: %s, %d, %.2f, %.*s und positionale Formen wie %1$s starten alle mit einem einzelnen Prozent. Um ein literales Prozent zu drucken, müssen Sie zwei hintereinander schreiben—%%—damit der Formatter ein % ausgibt und nicht nach einem Konversionsbuchstaben sucht. Diese Regel zu vergessen ist ein Klassiker: eine Meldung wie "done 50%" wird zum Formatfehler oder stiehlt das nächste Argument.

Im Escape-Modus läuft sie über jedes Zeichen, ersetzt jedes % durch %%, wandelt Backslashes und übliche Steuerzeichen in das kürzeste portable Escape um und lässt gewöhnlichen druckbaren Text unverändert. Im Unescape-Modus faltet sie %% zurück zu einem einzelnen Prozent, expandiert die unterstützten Backslash-Sequenzen, lässt ein einzelnes Prozent (Start einer echten Konversion) unverändert, damit gemischte Formatvorlagen dekodiert werden können, und lehnt abschließende Backslashes, unvollständige \x-Sequenzen, Nicht-Hex-Ziffern und unbekannte Buchstaben-Escapes ab, die bei strenger Lesart undefiniert wären.

Was Sie senden und was Sie zurückerhalten

Senden Sie ein Pflicht-Stringfeld namens text und ein optionales Feld mode. Wenn mode weggelassen wird, ist escape der Standard, sodass eine einzelne Nutzlast weiterhin sinnvoll arbeitet. Modus escape wandelt Klartext in einen printf-sicheren Formatkörper in result um: jedes Prozent wird verdoppelt, Backslashes werden zu \\ und Steuerzeichen zu \n, \r, \t oder \xHH.

Modus unescape kehrt diese Sequenzen um und liefert die wiederhergestellte Zeichenkette in result. Validierungsfehler belasten den vorab aufgeladenen KIT-Kontostand nicht. Klassische Checks umfassen das Escapen einer Fortschrittszeile mit bloßer Prozent und Zeilenumbruch, das Unescapen eines Körpers mit %% und \t, den Roundtrip einer Zeichenkette, die bereits Backslashes enthält, und das Ablehnen einer Zeichenkette, die mit einem nackten Backslash endet.

Wo ein Printf-Format-Escaper seinen Nutzen bringt

Codegeneratoren, die Log-Vorlagen, Lokalisierungskataloge und Assert-Meldungen für C, C++ oder printf-kompatible Laufzeiten erzeugen, müssen jedes Freitextfeld escapen, bevor es in einen Formatstring geschrieben wird, sonst zerstört ein einziges Prozent in einem Produktnamen das Format und bricht den Build oder stürzt zur Laufzeit ab. Teams für Embedded-Firmware und Gerätetreiber fügen Protokoll-Dumps und Bedienermeldungen ein, die bereits %% und \n-Sequenzen enthalten, und brauchen einen Unescape-Pfad, der bei abgeschnittenen \xHH laut scheitert statt Bytes zu erfinden. Dokumentations- und Rezeptseiten mit Copy-Paste-printf-Beispielen brauchen einen zuverlässigen Escape-Pfad, damit nutzerseitige Proben gültige Formatkörper bleiben.

Curriculum-Autoren, die printf-Syntax lehren, wollen Beispiele, die Prozentverdopplung explizit nennen—genau die Suchintention, die diese Landingseite abdeckt. Wenn Sie vollständige C-Stringliterale, JavaScript-Escapes, HTML-Entitäten oder URL-Prozentkodierung brauchen, behandeln Sie diese als getrennte Suchintentionen und Landings und überladen Sie diese Printf-Format-Escaper-Seite nicht.