CSVフィールド引用符
He said "Hi", friendというセルは"He said ""Hi"", friend"になります。二重引用符で囲み、中の引用符を2つに重ねるRFC 4180の決まりどおりなので、カンマや引用符で列がずれません。囲みを外す逆の操作もでき、ブラウザで無料で使えます。
- 無料
- ブラウザで動作
- 登録不要
- データは端末の外に出ません
無料で実行
計算例
- テキスト
- He said "Hi", friend
- 計算モード
- Quote
- 結果
- "He said ""Hi"", friend"
- 長さ
- 24
CSVは一見単純ですが、商品名にカンマが含まれる、メモに二重引用符がある、セルが2行にまたがる、といった瞬間に崩れます。quoteモードは必要時（またはforceで常に）値を二重引用符で囲み、埋め込み引用符をすべて二重化します。行の組み立てや分割の前に、完全なCSVパーサーではなく、1セル分の信頼できる基準が必要なときにご利用ください。
CSVで引用符が必要になるとき
CSVは、カンマで区切った値を1行に並べる単純な形式に見えますが、商品名にカンマが入っていたり、メモに二重引用符があったり、1つのセルが2行にまたがったりすると、とたんに崩れます。RFC 4180では、カンマ、二重引用符、復帰、改行のどれかを含む値は二重引用符で囲む決まりです。これらを含まない値はそのままでもかまいませんが、すべての値を囲んで形をそろえることもできます。このツールはこの決まりを、1つのセルの値だけに当てはめます。
引用符の二重化とよくある間違い
囲んだ値の中にある二重引用符は、2つ続けて書きます。バックスラッシュで逃がす書き方はCSVの決まりにはありません。たとえば He said "Hi", friend は "He said ""Hi"", friend" になります。元に戻すときは、先頭が引用符なら末尾も引用符で、中の引用符はすべて2つ組でなければなりません。閉じていない値や、囲まれていないのに引用符を含む値は、推測で直さずに誤りとして知らせます。ファイル全体を読み込むツールではない点にも注意してください。
活用例
生成CSV行の安全なセル
列を結合する前に、フリーテキストの商品名・メモ・住所をそれぞれ引用符で囲み、カンマや引用符で行レイアウトがずれないようにします。
よくある質問
forceはいつ有用ですか？
全セルを均一に引用符付けしたい生成側に便利です。RFC 4180が要求するときだけにする場合はforceをfalseのままにしてください。
CSVの値に引用符が必要になるのはどんなときですか？
カンマ、二重引用符、復帰、改行のどれかを含むときです。どれも含まない値はそのまま返されるので、単純な識別子は短いまま保てます。
引用符をバックスラッシュで逃がしてはいけないのですか？
RFC 4180では、値の中の二重引用符は2つ続けて書く決まりで、バックスラッシュは使いません。このツールも、引用符を必ず2つ組にして出力します。
囲まれていない値に引用符が入っているとどうなりますか？
誤りとして扱います。RFC 4180では引用符を含む値は囲まなければならないため、その形は正しい値とは言えません。推測で直すことはしません。
CSVファイル全体を読み込めますか？
できません。このツールが扱うのは1つのセルの値だけです。行を組み立てたり分けたりする前に、セルごとに正しい形を確かめる用途に向いています。
関連ツール
開発者向け — APIアクセス
このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。
エンドポイント
Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。
お使いのスタックから呼び出す
curl -X POST https://api.kit.forhosting.com/enc/csv-quote \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"He said \"Hi\", friend"}'const res = await fetch("https://api.kit.forhosting.com/enc/csv-quote", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "He said \"Hi\", friend"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/csv-quote",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "He said \"Hi\", friend"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/csv-quote", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"He said \\"Hi\\", friend"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"He said \"Hi\", friend"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/csv-quote", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)リクエスト例
{
"text": "He said \"Hi\", friend"
}レスポンス例
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.csv_quote",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。
料金
単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。
エラー
| HTTP | コード | 意味 |
|---|---|---|
401 | unauthorized | APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。 |
402 | insufficient_balance | 残高が不足しています。チャージ後に再度お試しください。 |
404 | unknown_type | 指定されたタスクタイプは存在しません。タイプ名を確認してください。 |
429 | rate_limited | リクエストが多すぎます。しばらく待ってから再度お試しください。 |
技術的な注記
引用符の付け方を誤った1フィールドがパーサー、表計算、データパイプラインを後から気付きにくい形で壊します。本CSVフィールド引用符ツールはRFC 4180の規則を一度に1フィールドへ適用します。unquoteモードはその符号化を戻し、閉じられていない・中途半端にエスケープされたトークンではゴミを作らずにすぐにinvalid_inputで失敗します。
RFC 4180が単一CSVフィールドを引用符で囲む方法
quoteモードでは生の値をカンマ・引用符・CR・LFについて走査し、いずれかがあるかforceがtrueなら、テキストを包み埋め込み引用符を二重の対に置き換えて引用符付きトークンを組み立てます。いずれも無くforceがfalseなら、単純な識別子をコンパクトに保つため生の値をそのまま返します。unquoteモードでは先頭の二重引用符がそのトークン全体が引用符付きであることを示します。末尾も二重引用符でなければならず、内部の引用符はすべて対で現れ、外側の囲みを除いた本体が返ります。RFC 4180はCSVをカンマ区切りのフィールドからなるレコードとして定義し、曖昧になり得るフィールドには任意で二重引用符の囲みを許します。カンマ、二重引用符、復帰（CR）、改行（LF）のいずれかを含むフィールドは二重引用符で囲まなければなりません。引用符付きフィールドの内側では、文字としての二重引用符は2つの二重引用符の連続として書き、バックスラッシュによるエスケープにはしません。これらの特殊文字を含まないフィールドは裸のままでもよく、均一性のためにすべてを引用符で囲む生成側も認められます。本機能はその契約をちょうど1つのフィールドトークンに実装します。先頭引用符のない裸トークンはそのまま返しますが、なお引用符文字を含む裸トークンはRFC 4180上の合法な非引用フィールドではないため拒否します。経路はネットワークも乱数シードも壁時計も使わない純粋な文字列処理であり、同一入力は常に同一のJSONになります。成功したAPI呼び出しの料金は公開ベースの$0.002（アイテム単位）で、検証失敗は前払い残高を消費しません。
送信内容と戻り値
modeがunquoteのときはtext内の引用符付けを戻し、復元した平文をresultに返します。均一なレイアウトのため生成側が常に全セルを引用符で囲む場合はforceをtrueにしてください。検証失敗は前払い残高を消費しません。典型的な確認は、埋め込み引用符とカンマを含む挨拶のquote、結果トークンを元の文字へunquote、本来裸のままの単純語をforceで引用符付け、決して閉じない引用符付き文字列の拒否です。必須の文字列フィールドtextと、任意のmodeおよびforceを送ってください。modeを省略すると既定はquoteなので、1つのペイロードでも有用な処理が行えます。modeがquoteのときはセルの生テキストをRFC 4180のフィールドトークンとしてresultに格納します。forceの既定はfalseで、quoteモードはフィールドにカンマ・引用符・CR・LFがあるときだけ囲みます。応答はmode、force、元のtext、result、quoted（結果または入力トークンが引用符付きか）、needs_quotes（生値がRFC 4180上で引用符を要するかどうか）、resultのlengthをエコーします。text欠落、非文字列オブジェクト、未対応のmode、forceとして読めない値、文書化された最大長を超える文字列、閉じられていない引用符付きフィールド、引用符付き本体中の単独未エスケープ引用符、引用符を違法に含む裸フィールドは、すべてinvalid_inputと明確な英語メッセージで失敗します。成功時のAPI料金は公開ベースの$0.002（アイテム単位）です。
単一フィールドCSV引用符ツールが役立つ場面
表計算のインポート補助やサポートツールは散らかったセルを1つずつ貼り付け、半端に引用符の付いたチケットを黙って切り捨てず、はっきり失敗する可逆パスを必要とします。検索意図が違うからです。検証失敗は残高を消費しません。セル単位でCSV行を組み立てるコード生成やETLジョブは、カンマで結合する前に各フリーテキストフィールドを引用符で囲まなければ、カンマ付きの1つの商品名だけで後続の全列がずれます。データ衛生を教える教材作者は、複数行CSVクリーナに規則を埋めるのではなく、フィールド単位の引用符付け専用ページを望みます。csvフィールドのquote/unquoteを探す人はエスケープ規則を求めており、列の改名・重複排除ではありません。ユーザー作成の語句をエクスポートテンプレートに注入するローカライズやコンテンツのパイプラインは、表計算エンジンを立てずにエッジワーカーから本parseエンドポイントを呼べます。実装は純粋なparseのtier Aのため、成功した呼び出しは毎回公開の基本料金$0.002で、モデルトークンも外向きネットワークもありません。リクエストを1フィールドに保ち、結果文字列をテストに固定すれば、1セルのために完全なCSVフレームワークを抱え込まず、生成器・LMSプラグイン・エッジワーカー向けに再現可能な引用符付けが得られます。ファイル全体の清掃・結合・JSON変換が必要なら、このフィールド引用符ページを拡張せず、別の検索意図とランディングとして扱ってください。
連携の活用例
引用符付きの1セルを復号
ログ・チケット・fixtureのRFC 4180フィールドトークン1つをunquoteして読みやすいテキストに戻し、閉じ忘れや半端なエスケープは厳しく失敗させます。
CSVライブラリ向けゴールデンテスト
言語や表計算エクスポータをまたぎ、RFC 4180の二重化規則に合うquote/unquoteベクトルを生成・検証します。
技術的な質問
埋め込み引用符があるCSVフィールドをどうquoteしますか？
生のフィールドをtextに入れ、modeをquote（既定）にします。カンマ・二重引用符・CR・LFのいずれかで囲みが発動し、内側の引用符は""になります。例: He said "Hi" は "He said ""Hi""" になります。
CSVフィールドのunquoteはどうしますか？
符号化済みフィールドトークンをmode unquoteで送ります。引用符付きトークンは二重引用符で始まり終わり、内側の二重化された引用符は結果で1つに戻ります。不正なトークンはinvalid_inputで失敗します。
CSVファイル全体を解析しますか？
いいえ。本機能はちょうど1つのフィールドトークンのquote/unquoteのみです。複数行の解析や変換が必要なら、CSV清掃・CSVからJSON・マージなどファイル全体向けツールをご利用ください。
CSVフィールド引用符ツールの料金は？
ブラウザツールは無料です。APIリクエストは成功した呼び出しごとに前払いKIT残高から$0.002です。無効な入力は課金されません。