変換テーブル

概要

文字の変換に変換テーブルが使用される一般的なシナリオには以下の 2 つがあります。

• 多くのコンテキスト (URL、HTML、JSON など) では、特定の文字は許可されておらず、エスケープ・シーケンスで表す必要があります。このような場合、それらの文字と許可されている文字セットとの間で変換が必要となります。

• データベース外のソースから読み取る、またはデータベース外の宛先に書き込む場合、そのエンティティは InterSystems IRIS が使用しているものとは異なる文字セットを期待している可能性があります。この場合、文字エンコードを変換する必要があります。

特定のコンテキストの “変換テーブル” は、実際にはテーブルのペアです。1 つのテーブルは既定の文字セットを他言語文字セット (または他言語コンテキスト) に変換する方法を指定し、もう 1 つのテーブルは反対方向に変換する方法を指定します。InterSystems IRIS では、このテーブルのペアを、入力モードと出力モードを持つ 1 つの単位として参照して変換を実行します。したがって、HTML との間での変換を管理するための HTML 変換テーブルがあり、CP1250 文字セットとの間での変換を管理するための CP1250 変換テーブルがあります。

テーブルのリスト

以下は、InterSystems IRIS 変換テーブルのリストです。

出力エスケープ

ここでは、特定の変換テーブルが出力モードで文字を変換する方法を示します。

Unicode 文字の場合 (ASCII 255 より大きい文字) ：

• JSML および JSONML 変換テーブルは、ここで説明されていないエスケープを実行します。

• URL 変換テーブルは、ここで説明されていないエスケープを実行します。

• URI は、ASCII 255 より大きい文字を含めることができないため、URI 変換テーブルは関係ありません。このような文字で URI 変換テーブルを使おうとすると、<ILLEGAL VALUE> エラーが発生します。以下に例を示します。

  USER>set x=$char(955)
   
  USER>w $ZCVT(x,"O","URI")
   
  W $ZCVT(x,"O","URI")
  ^
  <ILLEGAL VALUE>
  

  

• HTML および XML 変換テーブルはエスケープを実行しません。

シーケンシャル文字変換と文字エスケープ

シナリオによっては、別の文字セットへの変換と文字エスケープの実行の、2 つの変換を実行したいことがあります。このような場合、処理の順序が重要であり、一般に適用可能な文字セットに変換してから、エスケープを実行する必要があります。逆方向の場合は、逆の順序で逆の変換を実行する必要があります。これを最も良く表す例を挙げます。ローカル文字セットを使用する文字列から始め、この文字列には Unicode 文字が含まれる可能性があるとします。この文字列を URI 内で使用する必要があるとします。URI には ASCII 文字のみを含めることができ、その文字セット内には一部の文字の特定のエスケープ・シーケンスがあります。この場合、URI で使用するために、次の 2 つのステップで文字列を変換できます。

1. まず、ローカル表現を ASCII (UTF-8 文字セット) に変換します。例えば、入力文字列 origstring が次のように指定されたとします。

    set utf8string = $ZCONVERT(origstring,"O","UTF8")
   

   

2. 次に、文字エスケープを適用します。

    set final = $ZCONVERT(utf8string,"O","URI")
   

   

   文字列 final は URI 内で使用しても安全です。

URI をローカル文字セットに戻すには、逆の処理を実行します。

1. エスケープされた文字をエスケープ解除します。

    set unescaped=$ZCONVERT(uristring,"I","URI")
   

   

2. UTF–8 からローカル表現に変換します。

    set local=$ZCONVERT(unescaped,"I","UTF8")
   

   

上の URI 変換テーブルのエントリで説明したように、文字セット変換をスキップして、直接変換することもできます。この場合、$ZCONVERT 関数が文字セットを変換します。

関連する API

現在使用可能な変換テーブルのリストは、以下の例 (改行が追加されています) に示す、%SYS.NLS.LocaleOpens in a new tab の XLTTablesOpens in a new tab プロパティを参照してください。

USER>SET nlsoref=##class(%SYS.NLS.Locale).%New()
 
USER>WRITE $LISTTOSTRING(nlsoref.XLTTables,", ")
Unicode, RAW, BIN, SAME, UTF8, UnicodeLittle, UnicodeBig, URL, JS, JSML, JSON, JSONML, HTML, 
XML, XMLA, XMLC, CP1250, CP1251, CP1252, CP1253, CP1255, CP437, CP850, CP852, CP866, CP874, 
EBCDIC, Latin2, Latin9, LatinC, LatinG, LatinH, LatinT

%Net.CharsetOpens in a new tab を使用して、InterSystems IRIS 内で文字セットを表すこともできます。このクラスは、以下のクラス・メソッドを含んでいます。

• GetDefaultCharset() は、現在の InterSystems IRIS ロケールの既定の文字セットを返します (次の見出しを参照)。

  以下に例を示します。

  USER>w ##class(%Net.Charset).GetTranslateTable("UTF8")
  UTF8
  

• GetTranslateTable() は、指定された入力文字セットの InterSystems IRIS 変換テーブルの名前を返します。

• TranslateTableExists() は、指定された文字セットの変換テーブルがロードされているかどうかを示します。

メソッド・シグニチャについては、%Net.CharsetOpens in a new tab のクラス・ドキュメントを参照してください。

関連概念

InterSystems IRIS のロケールとは、ユーザの言語、通貨記号、書式、および特定の国または地域に固有のその他の規約を指定するメタデータのセットです。ロケールには変換テーブルが含まれます。InterSystems IRIS は、各国言語サポート (NLS) という語句を使用して、ロケール定義を表示して拡張するために使用するツールとロケール定義を一括して示します。

ロケール定義の外側で、特定の InterSystems IRIS インスタンスは、入出力アクティビティに特定の変換テーブルを使用するように既定で構成されています。これらは、既定の変換テーブルまたは既定の入出力テーブルです。現在の既定値を確認するには、%SYS.NLS.TableOpens in a new tab を使用します。詳細は、クラス・リファレンスを参照してください。

関連項目

• $zconvert

• 各国言語サポートのシステム・クラスの使用法

• %SYS.NLS.LocaleOpens in a new tab

• %SYS.NLS.TableOpens in a new tab