Virgolette campo CSV

Il CSV sembra semplice finché un nome di prodotto non contiene una virgola, una nota non include virgolette doppie o una cella non occupa due righe. Un campo mal virgolettato rompe parser, fogli di calcolo e pipeline di dati in modi difficili da notare a posteriori. Lo usi quando le serve un oracolo affidabile per una cella — non un parser CSV completo — prima di assemblare o dividere righe altrove.

Come RFC 4180 virgoletta un singolo campo CSV

RFC 4180 definisce il CSV come record di campi separati da virgole, con chiusura opzionale tra virgolette doppie per campi altrimenti ambigui. Un campo che contiene una virgola, una virgoletta doppia, un ritorno a capo o un feed di riga deve essere racchiuso tra virgolette doppie. Dentro un campo virgolettato, una virgoletta doppia letterale si scrive come due virgolette doppie di seguito — mai come escape con barra rovesciata.

I campi senza quei caratteri speciali possono restare nudi, sebbene i produttori possano virgolettare tutto per uniformità. Questa capacità implementa quel contratto per esattamente un token di campo. In modalità quote esamina il valore grezzo in cerca di virgola, virgoletta, CR e LF; se ne appare uno, o se force è true, costruisce un token virgolettato avvolgendo il testo e sostituendo ogni virgoletta incorporata con una coppia raddoppiata.

Se non ne appare nessuno e force è false, il valore grezzo torna invariato così gli identificatori semplici restano compatti. In modalità unquote una virgoletta doppia iniziale significa che l'intero token è virgolettato: il carattere finale deve essere pure una virgoletta doppia, ogni virgoletta interna deve apparire come coppia, e il corpo recuperato torna senza la chiusura esterna.

Un token nudo senza virgoletta iniziale torna così com'è, ma un token nudo che contiene ancora una virgoletta viene rifiutato perché quella forma non è un campo non virgolettato legale secondo RFC 4180.

Cosa invia e cosa riceve in risposta

Invii un campo stringa obbligatorio chiamato text e i campi opzionali mode e force. La modalità quote converte il testo grezzo della cella in un token di campo RFC 4180 in result. La modalità unquote inverte le virgolette in text e restituisce il valore plain recuperato in result.

Force ha predefinito false, quindi la modalità quote avvolge solo quando il campo contiene virgola, virgoletta, CR o LF; imposti force a true quando il Suo produttore virgoletta sempre ogni cella per un layout uniforme. I fallimenti di validazione non consumano il saldo prepagato. Controlli classici: virgolettare un saluto con virgolette e virgola incorporate, togliere le virgolette dal token risultante fino ai caratteri originali, forzare le virgolette su una parola semplice che altrimenti resterebbe nuda, e rifiutare una stringa virgolettata che non si chiude mai.

Dove un virgolettatore di un solo campo CSV conviene

I generatori di codice e i job ETL che costruiscono righe CSV cella per cella devono virgolettare ogni campo di testo libero prima di unire con virgole, o un solo titolo di prodotto con virgola sposterà tutte le colonne successive. Gli aiuti di importazione dei fogli e gli strumenti di supporto incollano una cella disordinata alla volta e servono un percorso reversibile che fallisca in modo rumoroso su ticket a metà virgolettati invece di troncare in silenzio.

Chi insegna igiene dei dati vuole una pagina dedicata al virgolettamento a livello di campo piuttosto che seppellire la regola sotto un pulitore CSV multi-riga, perché l'intento di ricerca differisce: chi cerca di mettere o togliere virgolette a un campo CSV vuole le regole di escape, non rinominare colonne né deduplicare. La validazione fallita non consuma saldo.

Mantenga ogni richiesta a un campo, fissi le stringhe di risultato nei test e ottiene virgolettamento riproducibile per generatori, plugin LMS e worker edge senza trascinare un framework CSV completo per una sola cella.