ゲーム百科 · データの読み方

CSVのカンマ・引用符・改行を読む|履歴データの列ずれを防ぐ

CSVでは引用符の内側のカンマや改行も値の一部です。行と記録の違い、二重引用符、空欄、先頭0を含む識別子を具体例で読み解きます。

約8分で読めますゲームの仕組み
記録の項目を扱うための実物の機器と帳簿
記録の項目を扱うための実物の機器と帳簿 · Carissa Rogers / CC BY 2.0 · 写真クレジット

CSVの列は、すべてのカンマを単純に区切れば読めるわけではありません。"blue,green"のように二重引用符で囲まれた部分では、内側のカンマは値の一部です。メモに改行が含まれる場合も、一つの記録がテキスト表示の複数行へ広がります。

履歴の識別子、日時、状態、数値を表として確認するときは、値の境界と列の意味を別々に確かめます。列がずれずに開けても、先頭の0が消えたり、時刻が日付へ短縮されたりすると、元の記録との照合に必要な情報が変わってしまいます。

行と列は、改行とカンマだけでは決まらない

CSVは値を区切って並べる形式ですが、値そのものにカンマや改行が入る場合があります。引用符の内側か外側かを見なければ、一つの値の終わりを正しく判断できません。

CSVの要素役割確認すること
レコード一組の関連した値引用内の改行と区別
フィールド一つの列の値引用符内のカンマを維持
ヘッダー列名の並び有無と列数を確認

3つの項目を一つのレコードとして読む

R-001,completed,120という記録なら、R-001、completed、120の3項目です。先頭は識別子、次は状態、最後は数値という列の説明があって初めて、それぞれの意味が決まります。CSVの区切り方だけでは、120が秒なのか点数なのかまでは分かりません。

列の並びは、各レコードでそろえる必要があります。途中の行だけ状態と数値を入れ替えても、ファイルとして開けてしまう場合があります。見た目の表になったことと、列の意味が正しく対応していることは別の確認です。

先頭の見出しも同じ区切り規則でできる

round_id,status,valueという見出しは、後ろの値を説明する行です。ただし、すべてのCSVが見出しを持つとは限りません。最初の行が文字だから必ず見出しとも判断できず、出力元の説明に従って列の有無を区別します。

見出しがある場合、その数と各レコードの項目数を比べると、ずれを見つけやすくなります。3列の見出しに対して4項目へ分かれた行があれば、メモ欄のカンマが正しく引用されているかなど、具体的な原因を調べられます。

空白も値の一部として残る

R-001, completed,120という並びでは、completedの前に空白があります。区切り文字の直後だからといって、その空白を必ず無視する形式ではありません。識別子の前後に余分な空白があると、同じ見た目でも照合結果が変わる場合があります。

空白を取り除くかどうかは、列の意味に合わせて決めます。文章の先頭空白には意味があるかもしれませんが、固定形式の識別子では不要な入力と扱う場合があります。読み込み時にすべての値を一律に整形すると、元の値を変えてしまうことがあります。

CSVは区切り文字と引用符を一緒に読む
引用符内の引用符は二重化します。例は架空の記録です。 図は横にスクロールできます。
記録の項目を扱うための実物の機器と帳簿
記録の項目を扱うための実物の機器と帳簿 · John Snyder / CC BY-SA 4.0 · 写真クレジット

カンマを含むメモは二重引用符で囲む

カンマは通常、項目の境目です。一方、メモの文章に含まれたカンマは、その文章の一部です。二重引用符は、このカンマを区切りとして使わないという範囲を示します。

同じ文字数でも項目数は変わる

R-001,"blue,green",120なら、中央のblue,greenは一つの値なので全体は3項目です。引用符がなくR-001,blue,green,120となれば4項目に分かれます。カンマの個数に1を足すだけでは、両方を同じように読んでしまいます。

引用符は値の外枠であり、読み取った値にその外枠を含めるわけではありません。この例で中央の値として残るのはblue,greenです。画面で引用符が消えて表示されても、メモの内容が変わったとは限りません。保存形式と表示形式の違いです。

すべての項目を囲む方式もある

"R-001","completed","120"のように、カンマを含まない項目まで二重引用符で囲むこともできます。引用符の有無だけで、文字列や数値の型を確定するわけではありません。"120"という保存表記から読み取る値も、最初は文字として扱えます。

一部だけ引用するファイルと、すべて引用するファイルは、同じ内容を表す場合があります。CSVを再保存して見た目が変わっても、レコードと項目の値が同じなら、意味のある差とは限りません。比較は生の行だけでなく、読み取った値の単位でも行います。

引用符の手前に空白を入れない

R-001, "blue,green",120のように、引用符より前に空白がある表記は、厳密な読み方と読み込み側の寛容な処理で解釈が分かれることがあります。区切りの直後から引用を始めると、どの文字が外枠なのかが明確になります。

特定の表計算ソフトで開けたという結果だけでは、他の読み込み側でも同じ値になるとは限りません。ファイルをやり取りするときは、引用の開始位置と区切り文字の約束をそろえることが、見えない互換性の問題を減らします。

短いCSVの項目を読み取る

カンマや引用符を含む短い入力を使い、レコードと各フィールドの値を確かめます。

入力値を確かめる準備ができました。

引用符内の引用符は二重化します。例は架空の記録です。

値の中の引用符は二つ重ねて表す

値そのものに二重引用符を含めるときは、外側を二重引用符で囲み、内側の引用符を二つ続けます。外枠と中身を同じ記号で表すため、重ね方に意味があります。

読み取る値保存時の考え方起こりやすい混同
blue,green値全体を二重引用符で囲むカンマを列の境目と誤認
say "go"値内の引用符を二つ重ねるJSONのバックスラッシュ規則と混同
「確認済み」通常の文字として保持かぎ括弧をCSVの引用符と誤認

「say "go"」という値を残す

値がsay "go"なら、CSVでは"say ""go"""のように表せます。外側の一組はフィールドの範囲で、""と重なった部分は値の中にある一つの引用符です。読み取り後に引用符が一つずつ残るという関係になります。

引用符をバックスラッシュで置き換える書き方は、別の形式では一般的でも、このCSVの規則と同じではありません。JSONに慣れていても、そのエスケープ方法をそのままCSVへ持ち込むと、文字が余分に残ったり、項目の境界がずれたりします。

日本語のかぎ括弧は外枠の引用符ではない

「確認済み」のような日本語のかぎ括弧は、通常の値の文字です。CSVの外枠に使う半角の二重引用符とは役割が異なります。かぎ括弧で囲んだからといって、その中の半角カンマが区切りから外れるわけではありません。

全角の引用符や似た形の装飾文字も、機械が同じ記号として読むとは限りません。見た目ではなく文字の種類に意味があるため、入力支援で引用符が自動的に別の形へ変わると、元の区切り規則が崩れる場合があります。

閉じ忘れは次の行まで影響する

開いた引用符を閉じないと、その後の改行を値の一部として読み続ける可能性があります。1行の誤りが、その行だけでなく後ろのレコードの読み方にも影響します。途中から列がずれる場合は、直前の引用符の数と位置を確認します。

単に引用符が偶数個あるかを調べるだけでも十分ではありません。二つ重なった引用符は値の中の一文字であり、外枠の開始や終了とは異なるためです。どの状態で読んでいるかを追える読み込み処理が必要になります。

記録の項目を扱うための実物の機器と帳簿
記録の項目を扱うための実物の機器と帳簿 · Jovonni Pharr / CC BY 3.0 · 写真クレジット

画面の1行と、一つの記録は一致しないことがある

CSVでは、引用されたフィールド内に改行を含められます。そのため、テキスト表示で2行に見える部分が一つのレコードという場合があります。行数を数えるときは、物理的な改行と記録の区切りを分けます。

メモの改行をそのまま保存する

メモが「最初の説明」と「補足」の2行なら、そのメモ全体を引用符で囲むことで、一つの項目として残せます。識別子と数値が同じレコードに属したまま、中央の文章だけが複数行になる構造です。

テキストエディターの行番号が2つ進んでも、記録が2件増えたとは限りません。件数を知りたいときは、CSVの引用規則を解釈した後のレコード数を数えます。画面に見える行をそのまま件数として使うと、改行を含むメモの分だけ過大になります。

改行コードと文字としての記号を区別する

実際の改行と、バックスラッシュにnを続けた2文字は異なります。後者は表示上の約束として使われる場合がありますが、CSVが自動的に改行へ変換するわけではありません。出力側が何を保存しているかで、読み取った文章の形が変わります。

同様に、行末のCRLFとLFの扱いも読み込み環境によって差があります。互換性を調べるときは、目に見えない改行の種類と、値の中に含まれた改行を別々に確認します。単純な全文置換は、必要なメモの改行まで壊すことがあります。

コピーした一部分だけでは引用が欠ける

複数行のメモの途中だけをコピーすると、外側の引用符が抜けてしまう場合があります。その断片を独立したCSVとして読み込むと、もとの項目の範囲を再現できません。一部を取り出すときも、レコード全体または値を再び正しく書き出す必要があります。

表として読み込んでから必要な行を選び、CSVとして再出力すれば、値の中身に合わせて引用を付け直せます。生のテキストの行番号で切り取る方法とは違い、項目の意味を保った単位で扱うということです。

識別子と数値を見た目だけで変換しない

CSV自体は、各列の型を十分に説明する仕組みを持ちません。数字に見える文字でも、計算する量ではなく番号や識別子という場合があります。読み込み側の自動変換は、元の意味と一致するかを確かめます。

先頭の0が意味を持つ番号

00125という識別子を数値へ変えると125になります。計算上は同じ数でも、文字列としての番号は違います。識別子に含まれる先頭の0を残す必要がある場合は、その列を文字列として扱うことが重要です。

長い番号では、表示の短縮や数値の精度の制約によって、末尾の数字が変わったように見える場合もあります。番号の列に合計や平均は不要であることが多く、まず文字として完全に保持し、照合に必要な形を保つほうが適切です。

通貨コードと金額の列をセットで読む

120という値だけでは、120円か120セントか120点か分かりません。currencyやunitといった別の列が、その数値の意味を決める場合があります。金額らしい列を見つけても、単位の説明を伴わずに別の通貨へ換算することはできません。

表示用の1,200という数値がCSVへ入る場合、カンマを含む一つの文字列として引用されるか、区切りのない1200という値で書き出されることがあります。保存値と表示の桁区切りを混同すると、金額が二つの列へ分かれたように読んでしまいます。

日付の自動変換で元の表記を失わない

2026-11-18のような値を表計算へ読み込むと、日時型へ自動変換される場合があります。再保存時の地域設定によって表記が変わると、元の文字列と一致しなくなります。日付の意味が同じかと、文字が同じかは分けて調べます。

特にオフセット付きのタイムスタンプは、単なる日付へ短縮すると時刻や基準が失われます。あとから他の記録と照合する予定があるなら、元の表記を残す列を用意し、読みやすい表示は別に作ると検算しやすくなります。

記録を残すために製本された実物の帳簿
記録を残すために製本された実物の帳簿 · Edinburgh City of Print / CC BY 2.0 · 写真クレジット

文字コードと表計算の解釈は別の確認

CSVの値が正しく区切られていても、日本語が読み込めない場合があります。また、表計算ソフトが文字列を式として解釈することもあります。区切り規則、文字コード、表示先の動作は別々の層です。

文字化けはカンマの誤りとは限らない

日本語が意味のない文字へ変わっていても、3列という構造自体は保たれていることがあります。これは区切りの問題ではなく、文字をバイトへ対応させる規則が一致していない可能性があります。UTF-8など、出力側と入力側の文字コードを合わせて調べます。

同じファイルを別の読み込み設定で開き直すときは、元のファイルをそのまま残しておきます。文字化けした表示を上書き保存すると、元の文字を復元するための情報まで失う場合があります。表示の失敗を保存値の変更へ広げないことが大切です。

引用符で囲んでも式の扱いは変わり得る

表計算では、先頭の等号などを式として扱う場合があります。CSVで二重引用符に囲まれていても、読み込んだ後にその値が式として解釈されるかどうかは別の処理です。引用符は列の境界を守る仕組みで、あらゆる実行を防ぐ仕組みではありません。

外部から届いた記録の文章を開く際は、読み込み設定で文字列として扱えるかを確かめます。記号を削る方法は元の値を変えるため、保存用と閲覧用を分けて考えます。知らない式を有効にする必要はなく、値として確認できる形を優先します。

必要な列だけ共有する

CSVには、画面では省略されていた連絡先や内部の識別子が含まれる場合があります。表に見えるからそのまま共有してよいとは限りません。照合に必要な列と、個人情報を含む列を分け、不要な内容を残さないことが基本です。

マスクした画面の横に元のCSVを添付すると、伏せたはずの値がファイルに残ることがあります。共有する対象は表示だけでなく、添付の中身まで含みます。見えない列、非表示の値、メモ欄の個人情報も確認してから渡します。

サンプルは、区切った後の値を一つずつ確かめる

CSVの読み取り例では、入力した文字列が何件のレコード、何個の項目になるかを比較します。引用符を増減した結果が、列の見た目ではなく値の範囲を変えることを確認できます。

カンマ入りの値を比較する

blue,greenを引用せずに置いた場合と、全体を二重引用符で囲んだ場合を比べると、項目数が一つ変わります。引用された値の中にカンマが残ることを確かめれば、カンマの削除と正しい引用が異なる操作だと分かります。

メモのカンマを全部消して列ずれを直す方法は、元の文章も変えてしまいます。正しく引用すれば、文章の内容を変えずに構造を保てます。データを整えるときは、問題が内容なのか、その内容の保存方法なのかを分けます。

空欄の位置を維持する

R-001,,120なら、中央の項目は空であり、全体は3項目です。空だからといって項目を詰めると、120が状態の列へ移ってしまいます。空欄は項目が存在しないことではなく、その位置に値がないことを表す場合があります。

最後の項目が空なら、行末のカンマの意味も確認します。列の定義が3つなのに2つしかないのか、3つ目が空なのかで読み方が変わります。列数と位置を同時に確かめると、空値を含む記録でも対応関係を保てます。

エラーは元の行へ戻って調べる

引用符が閉じていない入力は、強引に列へ分けず、どの位置から構造が崩れたかを調べる対象です。行番号だけでなく、引用の内側に入った場所と閉じる位置を追うと、次の行まで巻き込まれた原因が見えます。

実際の記録の内容を変えて試す代わりに、個人情報を含まない短いサンプルで規則を確かめられます。小さな例で区切り方が分かってから、元のファイルの列数や値を照合するという順序なら、必要な情報を誤って消しにくくなります。

記録の項目を扱うための実物の機器と帳簿
記録の項目を扱うための実物の機器と帳簿 · Triple-green / CC BY 2.0 · 写真クレジット

よくある質問

カンマの数に1を足せば列数になりますか?

引用符で囲まれた値にカンマが入る場合は、その方法では数えられません。引用の内側と外側を区別してからフィールドを数えます。

値の中に二重引用符を入れるには?

値全体を二重引用符で囲み、中の二重引用符を二つ重ねます。読み取り後は重ねた部分が一つの引用符として値に残ります。

空欄は削除して詰めてもよいですか?

列の位置が変わるため、勝手には詰めません。R-001,,120なら中央の項目が空で、120は3番目の項目のままです。

テキストの行数と記録件数が違うのはなぜですか?

引用されたフィールドの中に改行を含められるためです。物理的な改行の数と、解釈した後のレコード数は一致しない場合があります。

00125が125になったのはCSVの規則ですか?

読み込み側が数値へ自動変換した可能性があります。識別子なら文字列として扱い、先頭の0や長い桁を保持します。

二重引用符で囲めば表計算の式にはなりませんか?

引用符はCSVの区切りを守るためのもので、表計算側の式の解釈とは別です。外部の値は読み込み設定で文字列として確認するなど、閲覧側の動作も確かめます。

日本語の文字化けは区切り文字の誤りですか?

文字コードの不一致でも起こります。列数が合っているかと、日本語を正しく復号できているかは別々に調べます。

CSVを共有するときに確認する欄は?

必要な識別子や状態だけでなく、連絡先、メモ、非表示列などに個人情報が残っていないかを確認します。画面をマスクしても添付ファイルに元の値が残る場合があります。