Escape formato printf

Le stringhe di formato della famiglia printf trattano un segno di percentuale isolato come l'inizio di una specifica di conversione, quindi testo libero che contiene una percentuale—etichette di avanzamento, note di valuta, modelli di log—andrà in errore, sarà analizzato male o consumerà gli argomenti sbagliati a meno che ogni percentuale letterale non sia raddoppiata in %%. Allo stesso tempo, i corpi di formato spesso vivono dentro letterali di codice sorgente o file di configurazione dove newline, tabulazioni e backslash devono essere scritti come escape con barra. Questo escape di formato printf trasforma testo semplice in un corpo di formato sicuro raddoppiando ogni percentuale e riscrivendo caratteri di controllo e barre come \\ , \n, \r, \t o \xHH, e inverte la stessa mappa quando Lei deve recuperare i caratteri originali.

Come funzionano il raddoppio della percentuale e gli escape con backslash in printf

Nel printf di C, negli iostream C++ che accettano stringhe in stile printf, nel vecchio formattazione % di Python e in molte librerie di logging, un carattere percentuale inizia una conversione: %s, %d, %.2f, %.*s e forme posizionali come %1$s iniziano tutte con un solo percentuale. Per stampare una percentuale letterale Lei deve scriverne due di seguito—%%—così il formattatore emette un % e non cerca una lettera di conversione. Dimenticare quella regola è un bug classico: un messaggio come "done 50%" diventa un errore di formato o ruba l'argomento successivo.

Questa capacità applica entrambi i livelli in modo deterministico. In modalità escape scorre ogni carattere, sostituisce ogni % con %%, trasforma barre e i controlli usuali nell'escape portabile più corto e lascia invariato il testo stampabile ordinario. In modalità unescape ripiega %% in un solo percentuale, espande le sequenze supportate, lascia un percentuale isolato (inizio di una conversione reale) così com'è per decodificare modelli misti, e rifiuta backslash finali, sequenze \x incomplete, cifre non hex e escape di lettere sconosciute che sarebbero indefiniti in una lettura rigorosa.

Cosa invia Lei e cosa riceve indietro

Invii un campo stringa obbligatorio chiamato text e un campo opzionale mode. La modalità escape converte testo semplice in un corpo di formato sicuro per printf memorizzato in result: ogni percentuale è raddoppiata, i backslash diventano \\ e i controlli diventano \n, \r, \t o \xHH. La modalità unescape inverte quelle sequenze e restituisce la stringa recuperata in result.

I fallimenti di validazione non consumano saldo prepagato. Controlli classici includono l'escape di una riga di avanzamento con percentuale isolata e newline, l'unescape di un corpo che usa %% e \t, l'andata e ritorno di una stringa che contiene già backslash, e il rifiuto di una stringa che termina con un backslash nudo.

Dove un escape di formato printf merita il suo posto

I generatori di codice che emettono modelli di log, cataloghi di localizzazione e messaggi di assert per C, C++ o runtime compatibili con printf devono fare l'escape di ogni campo di testo libero prima di scriverlo in una stringa di formato, o un singolo percentuale in un nome prodotto corromperà il formato e romperà la build o andrà in crash a runtime.

I team di firmware embedded e driver di dispositivo incollano dump di protocollo e messaggi operatore che contengono già %% e sequenze \n e hanno bisogno di un percorso di unescape che fallisca in modo rumoroso su \xHH troncati invece di inventare byte. I siti di documentazione e ricettari che mostrano esempi printf da copiare e incollare necessitano di un percorso di escape affidabile affinché i campioni dell'utente restino corpi di formato validi.

Le pipeline QA e CI confrontano vettori dorati di escape e unescape tra host così un percentuale letterale è sempre %% e una newline è sempre \n. Gli autori di curricula che insegnano la sintassi printf vogliono esempi che menzionino esplicitamente il raddoppio della percentuale, che è l'intento di ricerca che questa landing cattura. Se Lei ha bisogno di letterali stringa C completi, escape JavaScript, entità HTML o percent-encoding URL, li tratti come intenti e landing separati piuttosto che sovraccaricare questa pagina dell'escape di formato printf.