スマートクォートをASCII変換|コードの構文エラー解決

公開ツールスマートクォート変換ツール(ASCII化)

目次
  1. スマートクォートがコードエラーの原因になる理由
  2. 標準の ASCII 引用符に戻す方法
  3. ツールが検出・変換する文字グループ
  4. まとめ
  5. よくある質問

ワード(MS Word)やワープロソフト、あるいは KakaoTalk や Slack のようなメッセンジャーのエディタ画面で長い文章や開発用のソースコードを入力し、それを Web ブラウザのエディタやプログラミング用のコンパイラ画面にそのまま貼り付けることはよくあります。そうやって貼り付けたコードが正常にビルドされず、構文エラー(Syntax Error)を起こしてしまう――そんな経験を一度はしたことがあるのではないでしょうか。

このエラーの主な原因は、エディタの自動書式変換機能です。標準の ASCII 引用符を、見た目が曲線状のスマートクォート(Smart Quotes)に置き換えてしまうからです。この記事では、スマートクォートが発生する原因と、標準の ASCII 引用符に戻す方法をまとめます。

まとめ

  • ① ワードやメッセンジャーのエディタにある自動書式変換機能が、標準の ASCII 引用符を曲線状のスマートクォートに変えてしまい、コンパイラが認識できない構文エラーが発生します。
  • ② エディタの自動書式オプションをオフにする、あるいは文字を1つずつ探して標準文字に置き換えるという手作業でも戻せますが、文章が長いほど見落としが生まれます。
  • ③ スマートクォート変換ツール(ASCII化)に貼り付ければ、ダブルクォート・シングルクォート・ダッシュ・その他の4グループの文字を一度に標準 ASCII へ変換し、グループごとの変更件数もあわせて表示します。

スマートクォートがコードエラーの原因になる理由

コンパイラやインタプリタのエンジンは、標準 ASCII の範囲内にある1バイトの直線的な引用符だけを構文トークンの識別子として受け付けます。ワードやメッセンジャーのエディタが自動で置き換えるスマートクォートは、見た目は似ていても Unicode 上はまったく別の文字なので、コンパイラはそれを認識できず構文エラーを引き起こします。

種類文字の形(Glyph)Unicode コードポイントコンパイラの受け付け
標準シングルクォート(ASCII)'\u0027 (Apostrophe)O(正常に認識)
標準ダブルクォート(ASCII)"\u0022 (Quotation Mark)O(正常に認識)
スマートシングルクォート(開き)‘\u2018 (Left Single Quote)X(構文エラーを誘発)
スマートシングルクォート(閉じ)’\u2019 (Right Single Quote)X(構文エラーを誘発)
スマートダブルクォート(開き)“\u201C (Left Double Quote)X(構文エラーを誘発)
スマートダブルクォート(閉じ)”\u201D (Right Double Quote)X(構文エラーを誘発)

標準の ASCII 引用符に戻す方法

手作業で戻す

  1. エディタの自動書式オプションを解除: 文章を書く機会が多いワードや macOS 標準のテキストエディットの環境設定を開き、Smart Quotes または 自動引用符変換 のオプションを手動で無効化(Uncheck)しておけば、コーディング用のテキストがそもそも損なわれるのを防げます。
  2. コピー前のテキスト点検: すでにスマートクォートが混ざってしまった文章なら、開発ガイドのドキュメントやコードスニペットを配布する前に、引用符とダッシュを1つずつ探して標準文字に置き換える必要があります。文章が長かったり、引用符があちこちに混ざっていたりすると、いくつか見落としやすく、どの文字がいくつ変わったのかを目で確認するのも難しいものです。

ツールで一度に変換する

そのたびにテキストエディタでエラーの出ている箇所を1文字ずつ探し、引用符を消して入力し直す代わりに、スマートクォート変換ツール(ASCII化)にソースコードを貼り付ければ、上記の文字が一度に標準 ASCII テキストへ変わり、グループごとの変換件数もあわせて表示されます。貼り付けた文章に特殊文字がいくつ残っているかを自分で数える代わりに、下のツールに貼り付けて一度に確認してみてください。

スマートクォート変換ツール(ASCII化)

引用符の書式が崩れてエラーが出るテキストや開発コードを貼り付けて、標準コンパイラ向けのASCII記号にやさしく復元してみてください。

ツールが検出・変換する文字グループ

スマートクォート変換ツール(ASCII化)は、正規表現で以下の4グループの文字をそれぞれ数えながら、同時に標準 ASCII 文字へ置き換えます。

グループ検出対象変換結果
ダブルクォート類スマートダブルクォート(開き/閉じ)、下向き9字形ダブルクォート、ギュメ(ギルメ)符号"
シングルクォート類スマートシングルクォート(開き/閉じ)、バッククォート、アクサン(強勢)符号、下向き9字形シングルクォート、シングルギュメ符号'
ダッシュ類エンダッシュ、エムダッシュ、水平線、フィギュアダッシュ、マイナス記号-
その他省略記号(…)、改行なしスペース(NBSP)...、通常のスペース

ダブルクォート類・シングルクォート類・ダッシュ類・その他に分けて数えるのは、結果画面でどの種類がいくつ変わったかをすぐに示すためです。ワードの文書から持ってきた文章はたいてい引用符や省略記号が混ざっているので、こうして分けて見れば、どこでどれだけ損なわれたのかを把握しやすくなります。

まとめ

スマートクォートは、ワードやメッセンジャーのエディタの自動書式変換機能が標準 ASCII の引用符を曲線状の文字に変えてしまうことで生まれます。エディタの自動書式オプションをオフにする、あるいは文字を1つずつ探して置き換える手作業でも対処できますが、文章が長くなるほど見落とす箇所は増えていきます。

スマートクォート変換ツール(ASCII化)に貼り付ければ、ダブルクォート・シングルクォート・ダッシュ・その他の4グループの文字を一度に標準 ASCII へ変換します。グループごとに何件変わったかもあわせて確認できます。

スマートクォート変換ツール(ASCII化)

引用符の書式が崩れてエラーが出るテキストや開発コードを貼り付けて、標準コンパイラ向けのASCII記号にやさしく復元してみてください。

よくある質問

コーディングやデータ移行で特殊な引用符が問題になるのはなぜですか?

通常の引用符(")と違い、スマートクォート(“ や ”)は一部のテキストパーサーやプログラミング言語でエラーを引き起こしたり、データ破損の原因になったりするからです。

スマートクォート変換ツール(ASCII化)はどうやって使うのですか?

整理したい文章をテキストエディタの欄に貼り付けると、変換後の ASCII テキストとグループごとの変更回数がリアルタイムで確認でき、コピーボタンで完成版をそのまま持ち出せます。

エディタの自動書式オプションをオフにすれば、この問題はまったく起きないのですか?

ワードや macOS のテキストエディットで Smart Quotes(自動引用符変換)のオプションをあらかじめオフにしておけば、新しく入力する文章にはスマートクォートは入りません。ただし、すでに書かれていた既存の文章や外部から受け取ったテキストには適用されないため、そうした文章はツールで一度整理しておくほうが安全です。

この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む

関連記事

  1. ブラウザで音声入力する方法、Firefoxが対応しない理由Web Speech APIを使えば、インストールなしでブラウザのマイクから音声をリアルタイムに文字起こしできます。Chrome・Edgeで動いてFirefoxで動かない理由と、途中で認識が切れる仕組みを整理します。
  2. 文単位の改行|記号と空白で文を分割する正規表現ルールピリオド・疑問符・感嘆符の後に空白がある位置を文の区切りとして判定し、小数点や英語の略語を誤分割しないための例外ルールを解説します。出力形式と文字数の統計も確認できます。
  3. SQL DDLからJSON Schemaへの型マッピング規則CREATE TABLE文のSQL型やNOT NULL・PRIMARY KEYなどの制約が、JSON Schema Draft-07のtypeやrequiredにどう変換されるかの規則を整理して解説します。
  4. SQLフォーマッターの整形ルール|改行と大文字化の仕組み1行に詰まったSQLをフォーマッターが整列する際のルールを解説。キーワードだけ大文字化し、句ごとに改行、条件とサブクエリは字下げ。整形が実行結果を変えない理由もまとめました。
  5. SQLパラメータバインディングの置換ルールを確認?, :id, @name に実際の値がどう入り、どうエスケープされるかを規則で整理。数値やNULLはそのまま、文字列は引用符で囲み、コメントや文字列内の?が変わらない理由も結果で確かめられます。
  6. 文字列エスケープの変換ルール|JSON・JSでの対応表バックスラッシュ・引用符・改行・タブがJSONやJS文字列でどの記号に変わるかを表で整理。アンエスケープで戻す際の違いや、間違えやすい点も解説します。

関連ツール