CSV Dock / 開発者向けドキュメント
MITライセンス・無料v0.1.0パッケージ公開準備中

人名異体字を、勝手に置き換えない。

似ている字でも、氏名の表記として同じとは限りません。cp932-lintは人名異体字を報告し、置換候補を返さず、変換処理でも置き換えません。

変換できることと、氏名が正しいことを分ける

𠮷はCP932では表現できません。はCP932で表現できますが、受入先が拡張文字に対応していない場合などに注意が必要です。どちらも「よく似た字に置換してよい」という意味ではありません。

人名異体字のsuggestionは常にnullです。

standardFormは比較・表示の参考用です。本人の氏名表記を変更するための変換表ではありません。customMapを使っても、辞書で人名異体字に分類された文字は自動置換しません。

人名コンテキストを使う

import { lint, convert } from '@csvdock/cp932-lint';

const result = lint('𠮷田,髙橋', { context: 'jinmei' });
// 𠮷: error、髙: warning。suggestionはいずれもnull。

// context: 'jinmei'で置換を指定するとConversionError。
// バイト列を返しません。
convert('𠮷田', { context: 'jinmei', replace: 'safe' });

context: 'jinmei'は、登録された異体字以外も含め、入力全体に対して置換の提案と実行を抑制します。convertではreplace: 'none'を使ってください。'safe'または'custom'を指定すると例外になります。氏名の列だけに適用したい場合は、呼び出し側でその列の文字列を取り出して検査してください。

これは全人名の識別器ではありません。辞書にない異体字や、結合文字・異体字セレクタを含む表記もあります。人名を扱うシステムでは原文を保持し、受入先と文字の仕様を確認してください。

登録している人名異体字

パッケージのJINMEIデータから表示しています。CP932での可否と、表記を保持する際の注意点を文字ごとに確認できます。

𠮷 U+20BB7

CP932に含まれない・エラー

人名などに使われる異体字で、CP932 に存在しません。別の字に置換せず、UTF-8 で元の表記を保持してください。

比較用の字形:。自動置換の候補ではありません。

𠮟 U+20B9F

CP932に含まれない・エラー

人名などに使われる異体字で、CP932 に存在しません。別の字に置換せず、UTF-8 で元の表記を保持してください。

比較用の字形:。自動置換の候補ではありません。

𠀋 U+2000B

CP932に含まれない・エラー

人名などに使われる異体字で、CP932 に存在しません。別の字に置換せず、UTF-8 で元の表記を保持してください。

比較用の字形:。自動置換の候補ではありません。

U+9AD9

CP932に含まれる・警告

人名などに使われる異体字です。CP932 では変換可能ですが、受け取り側の対応を確認してください。別の字への自動置換は行いません。

比較用の字形:。自動置換の候補ではありません。

U+FA11

CP932に含まれる・警告

人名などに使われる異体字です。CP932 では変換可能ですが、受け取り側の対応を確認してください。別の字への自動置換は行いません。

比較用の字形:。自動置換の候補ではありません。

U+6FF5

CP932に含まれる・警告

人名などに使われる異体字です。CP932 では変換可能ですが、受け取り側の対応を確認してください。別の字への自動置換は行いません。

比較用の字形:。自動置換の候補ではありません。

U+5FB7

CP932に含まれる・警告

人名などに使われる異体字です。CP932 では変換可能ですが、受け取り側の対応を確認してください。別の字への自動置換は行いません。

比較用の字形:。自動置換の候補ではありません。

U+7028

CP932に含まれる・警告

人名などに使われる異体字です。CP932 では変換可能ですが、受け取り側の対応を確認してください。別の字への自動置換は行いません。

比較用の字形:。自動置換の候補ではありません。

U+908A

CP932に含まれる・警告

人名などに使われる異体字です。CP932 では変換可能ですが、受け取り側の対応を確認してください。別の字への自動置換は行いません。

比較用の字形:。自動置換の候補ではありません。

U+9089

CP932に含まれる・警告

人名などに使われる異体字です。CP932 では変換可能ですが、受け取り側の対応を確認してください。別の字への自動置換は行いません。

比較用の字形:。自動置換の候補ではありません。

U+9F4B

CP932に含まれる・警告

人名などに使われる異体字です。CP932 では変換可能ですが、受け取り側の対応を確認してください。別の字への自動置換は行いません。

比較用の字形:。自動置換の候補ではありません。

U+9F4A

CP932に含まれる・警告

人名などに使われる異体字です。CP932 では変換可能ですが、受け取り側の対応を確認してください。別の字への自動置換は行いません。

比較用の字形:。自動置換の候補ではありません。

U+974F

CP932に含まれる・警告

人名などに使われる異体字です。CP932 では変換可能ですが、受け取り側の対応を確認してください。別の字への自動置換は行いません。

比較用の字形:。自動置換の候補ではありません。

U+66FB

CP932に含まれる・警告

人名などに使われる異体字です。CP932 では変換可能ですが、受け取り側の対応を確認してください。別の字への自動置換は行いません。

比較用の字形:。自動置換の候補ではありません。

U+FA19

CP932に含まれる・警告

人名などに使われる異体字です。CP932 では変換可能ですが、受け取り側の対応を確認してください。別の字への自動置換は行いません。

比較用の字形:。自動置換の候補ではありません。

U+FA10

CP932に含まれる・警告

人名などに使われる異体字です。CP932 では変換可能ですが、受け取り側の対応を確認してください。別の字への自動置換は行いません。

比較用の字形:。自動置換の候補ではありません。

U+FA12

CP932に含まれる・警告

人名などに使われる異体字です。CP932 では変換可能ですが、受け取り側の対応を確認してください。別の字への自動置換は行いません。

比較用の字形:。自動置換の候補ではありません。

U+FA1E

CP932に含まれる・警告

人名などに使われる異体字です。CP932 では変換可能ですが、受け取り側の対応を確認してください。別の字への自動置換は行いません。

比較用の字形:。自動置換の候補ではありません。

変換できない氏名があるとき

  1. 元の氏名をUTF-8などで保持し、書き換えずに残します。
  2. 取込先がUTF-8や別形式を受け付けるか、文字の制限と合わせて確認します。
  3. CP932が必須なら、別項目で原文を保持する、手作業で照合するなどの運用を受入先と決めます。
  4. やむを得ず表記を変更する場合は、本人や業務上の責任者の確認を経て、変更内容を記録します。

外字も自動で置き換えません

外字は組織固有の文字定義を持つことがあります。同じコードでも、受入先のフォントや定義が違えば同じ字形とは限りません。検出対象のUnicode私用領域を確認し、双方の定義を確認してください。

CSV全体を画面で確認したい場合はCSV Dockの無料ツールを利用できます。保存形式を選ぶ手順は機種依存文字のガイドで説明しています。