Échappeur format printf

Les chaînes de format de la famille printf traitent un signe pour cent isolé comme le début d'une spécification de conversion, de sorte qu'un texte libre contenant un pour cent—libellés de progression, notes monétaires, modèles de journal—plantera, sera mal analysé ou consommera les mauvais arguments à moins que chaque pour cent littéral soit doublé en %%. En parallèle, les corps de format vivent souvent dans des littéraux de code source ou des fichiers de configuration où retours à la ligne, tabulations et barres obliques inverses doivent s'écrire sous forme d'échappements. Cet échappeur de format printf transforme du texte brut en un corps de format sûr en doublant chaque pour cent et en réécrivant les caractères de contrôle et les barres comme \\ , \n, \r, \t ou \xHH, et inverse la même carte lorsque vous devez retrouver les caractères d'origine.

Comment fonctionnent le doublement du pour cent et les échappements par barre en printf

Dans le printf de C, les iostreams C++ qui acceptent des chaînes de style printf, le vieux formatage % de Python et de nombreuses bibliothèques de journalisation, un caractère pour cent commence une conversion : %s, %d, %.2f, %.*s et les formes positionnelles comme %1$s commencent toutes par un seul pour cent. Pour imprimer un pour cent littéral, vous devez en écrire deux d'affilée—%%—afin que le formateur émette un % et ne cherche pas une lettre de conversion.

Oublier cette règle est un bug classique : un message comme "done 50%" devient une erreur de format ou vole l'argument suivant. Cette capacité applique les deux couches de façon déterministe. En mode escape elle parcourt chaque caractère, remplace chaque % par %%, transforme barres et contrôles usuels en l'échappement portable le plus court, et laisse le texte imprimable ordinaire inchangé.

En mode unescape elle replie %% en un seul pour cent, développe les séquences supportées, laisse un pour cent isolé (début d'une vraie conversion) tel quel pour décoder des modèles mixtes, et rejette les barres finales, les séquences \x incomplètes, les chiffres non hex et les lettres d'échappement inconnues qui seraient indéfinies en lecture stricte.

Ce que vous envoyez et ce que vous recevez

Envoyez un champ chaîne obligatoire nommé text et un champ optionnel mode. Lorsque mode est omis, escape est la valeur par défaut, de sorte qu'une seule charge utile reste utile. Le mode escape convertit le texte brut en un corps de format sûr pour printf stocké dans result : chaque pour cent est doublé, les barres deviennent \\ et les contrôles deviennent \n, \r, \t ou \xHH.

Le mode unescape inverse ces séquences et renvoie la chaîne récupérée dans result. Les échecs de validation ne consomment pas le solde prépayé. Les contrôles classiques incluent l'échappement d'une ligne de progression avec un pour cent isolé et un saut de ligne, le déséchappement d'un corps qui utilise %% et \t, l'aller-retour d'une chaîne qui contient déjà des barres, et le rejet d'une chaîne qui se termine par une barre seule.

Où un échappeur de format printf apporte une valeur réelle

Les générateurs de code qui émettent des modèles de journal, des catalogues de localisation et des messages d'assertion pour C, C++ ou des runtimes compatibles printf doivent échapper chaque champ de texte libre avant de l'écrire dans une chaîne de format, sinon un seul pour cent dans un nom de produit corrompra le format et cassera la compilation ou plantera à l'exécution.

Les équipes de micrologiciel embarqué et de pilotes collent des dumps de protocole et des messages opérateur qui contiennent déjà %% et des séquences \n et ont besoin d'un chemin d'unescape qui échoue bruyamment sur des \xHH tronqués au lieu d'inventer des octets. Les sites de documentation et livres de recettes qui montrent des exemples printf à copier-coller ont besoin d'un chemin d'échappement fiable pour que les échantillons fournis par l'utilisateur restent des corps de format valides.

Les pipelines QA et CI comparent des vecteurs dorés d'escape et d'unescape entre hôtes pour qu'un pour cent littéral soit toujours %% et un saut de ligne toujours \n. Les auteurs de cursus qui enseignent la syntaxe printf veulent des exemples qui mentionnent explicitement le doublement du pour cent, intention de recherche que cette page capture.

Si vous avez besoin de littéraux de chaînes C complets, d'échappements JavaScript, d'entités HTML ou d'encodage pourcent d'URL, traitez-les comme des intentions et pages distinctes plutôt que de surcharger cette page d'échappeur de format printf.