ForHosting KIT · Outils pour développeurs

Échappez un champ CSV : virgules, retours à la ligne et guillemets

Un champ CSV paraît simple jusqu’à ce que sa valeur contienne une virgule, un saut de ligne ou un guillemet.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Cet outil applique les règles d’échappement standard à une valeur textuelle afin que vous puissiez l’insérer sans risque dans une ligne séparée par des virgules. Il conserve le texte ordinaire, entoure de guillemets doubles les champs qui nécessitent une protection et double les guillemets internes. Le résultat est déterministe, immédiatement réutilisable et adapté aux tableurs, exportations, rapports générés et pipelines de données.

Transformez n’importe quel texte en champ CSV sûr

Le format CSV utilise les virgules et les fins de ligne pour séparer les champs et les enregistrements. Cela pose problème lorsque ces caractères appartiennent à la valeur elle-même. Collez ou envoyez une valeur textuelle : l’outil renvoie la représentation exacte qui peut occuper une seule position dans une ligne séparée par des virgules. Une valeur simple, comme un code de compte, reste inchangée. Une valeur contenant une virgule, un retour chariot, un saut de ligne ou un guillemet double est entourée de guillemets doubles. Chaque guillemet déjà présent devient deux guillemets consécutifs, ce qui permet à un lecteur CSV conforme de restituer le caractère d’origine. La transformation ne modifie que la syntaxe indispensable à la sûreté du CSV : elle ne supprime pas les espaces, ne normalise pas les fins de ligne, ne réinterprète pas les nombres et ne change pas la casse. Cette portée précise en fait un composant fiable lorsqu’une application assemble déjà les lignes et colonnes, mais exige une règle correcte et réutilisable pour chaque valeur. Une chaîne vide reste vide, car elle constitue déjà un champ vide valide.

Comprenez quand encadrer et doubler les guillemets

La distinction essentielle sépare le contenu de la structure CSV. Une virgule dans le nom d’une société ne doit pas créer une colonne, et un saut de ligne dans une adresse ne doit pas commencer un nouvel enregistrement. Entourer le champ complet de guillemets doubles indique à l’analyseur que ces caractères sont du contenu littéral. Les guillemets doubles imposent une règle supplémentaire : dans un champ CSV entre guillemets, chaque guillemet littéral est représenté par deux guillemets. L’outil détecte tous ces cas ensemble. Ainsi, un texte comprenant une virgule et un surnom entre guillemets reçoit une paire extérieure, tandis que chaque guillemet initial est doublé. Un texte sans caractère structurel est renvoyé tel quel, ce qui évite toute modification inutile tout en restant valide. Le traitement couvre les sauts de ligne Unix et les retours chariot d’autres systèmes. Il cible volontairement le CSV séparé par des virgules, et non les délimiteurs configurables. Pour des données séparées par tabulations ou points-virgules, appliquez les règles du format concerné. La sortie représente un champ, jamais une ligne, un en-tête ou un fichier complet.

Intégrez la valeur échappée aux exportations et pipelines

Placez le texte renvoyé directement entre les virgules produites par votre générateur de lignes, sans ajouter une nouvelle couche de guillemets. Appliquer l’opération séparément à chaque valeur source permet de créer simplement des lignes à partir de formulaires, résultats de bases de données, journaux ou rapports. L’algorithme étant déterministe et indépendant du réseau, une même entrée produit toujours le même champ échappé dans le navigateur et via l’API. Le résultat se teste facilement avec des jeux de données fixes et convient aux builds reproductibles. Évitez de traiter une seconde fois un champ déjà échappé, sauf si sa représentation est devenue la nouvelle valeur littérale : l’échappement CSV dépend du contexte et un second passage considérera à juste titre la première syntaxe comme du contenu. Cette capacité gère la syntaxe du champ, pas la sécurité des formules de tableur. Si un texte non fiable commençant par un signe égal doit être ouvert dans un tableur, évaluez séparément les protections contre l’injection de formules selon la politique du logiciel destinataire. Enfin, joignez les champs échappés par des virgules et terminez chaque enregistrement avec la fin de ligne attendue.

Créez une exportation CSV sûre

Échappez chaque valeur issue de la base de données ou de l’application avant de réunir les champs dans un enregistrement séparé par des virgules.

Conservez les adresses multilignes

Gardez les sauts de ligne intégrés dans un seul champ d’adresse sans créer accidentellement d’autres enregistrements CSV.

Protégez les noms et descriptions

Représentez correctement virgules et guillemets dans les noms de produits, notes et descriptions sans décaler les colonnes suivantes.

Quel est le prix d’une requête ?

Une requête API coûte $0.002. La même transformation déterministe est également disponible gratuitement dans le navigateur.

Toutes les valeurs reçoivent-elles des guillemets ?

Non. Le résultat est entouré de guillemets si le texte contient une virgule, un retour chariot, un saut de ligne ou un guillemet double ; sinon, il reste inchangé.

Comment les guillemets sont-ils échappés ?

Chaque guillemet double d’un champ encadré devient deux guillemets consécutifs, puis une paire de guillemets doubles entoure le champ complet.

Cet outil crée-t-il une ligne CSV complète ?

Non. Il renvoie un seul champ échappé. Échappez chaque valeur séparément, réunissez les résultats avec des virgules et ajoutez la fin d’enregistrement adaptée.

Les valeurs multilignes sont-elles acceptées ?

Oui. Le texte qui contient des retours chariot ou des sauts de ligne est encadré afin que ceux-ci restent dans un seul champ.

Cela empêche-t-il l’injection de formules dans un tableur ?

Non. L’outil applique uniquement la syntaxe des champs CSV. La protection contre l’injection de formules dépend du logiciel destinataire et requiert une politique séparée.

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

POSThttps://api.kit.forhosting.com/str/escape-csv-field

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

curl -X POST https://api.kit.forhosting.com/str/escape-csv-field \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Quarterly report, \"final\""}'
{
  "text": "Quarterly report, \"final\""
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "str.escape_csv_field",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →