Symfoware Server アプリケーション開発ガイド(埋込みSQL編) - FUJITSU -

3.1.5 日本語文字の使用方法

ここでは、アプリケーション中に日本語文字を使用する方法について説明します。

日本語文字コード系を選択することにより、アプリケーション中の日本語文字に対する処理が異なります。たとえば、SQL文に指定する日本語文字列型のホスト変数には、選択した日本語文字コードのデータを設定または参照してデータベースアクセスを行います。

このため、アプリケーションの設計時には、実行時にどの日本語文字コード系を選択するかを決定しておく必要があります。

アプリケーションの実行時には、動作環境ファイルの実行パラメタ“NCHAR_CODE”に選択した日本語文字コード系を指定してください。指定方法の詳細については、“クライアント用の動作環境ファイルの作成”を参照してください。

■プログラミングでの日本語文字コードの留意点

ここでは、選択したそれぞれの日本語文字コードでプログラミングする場合の留意点について説明します。

◆ホスト変数の長さ

各国語文字列型のデータをデータベースから取得、またはデータベースに格納する場合、日本語文字コードは2バイトとなります。このため、ホスト変数の長さは、以下のように算出してください。

ホスト変数の長さ ＝ 日本語文字数 × ２バイト ＋ １

ただし、EUCコードの日本語文字を使用する場合は、日本語文字に3バイトの拡張漢字または利用者定義文字を含む可能性があります。このため、ホスト変数の長さは、格納に十分な大きさを考慮して以下のように算出してください。

ホスト変数の長さ ＝ 日本語文字数 × ３バイト ＋ １

また、UTF-8形式の日本語文字を使用する場合は、日本語文字コードは2〜6バイトとなります。

ホスト変数の長さ ＝ 日本語文字数 × ６バイト ＋ １

◆SQL記述子域のオクテット長

動的SQLを使用して、各国語文字列型のデータをデータベースから取得する場合、SQL記述子域のオクテット長(バイト数)は、1文字を2バイトに換算した値となります。ただし、EUCコードの日本語文字を使用する場合は、取得するデータが2バイト表現の日本語文字か3バイト表現の日本語文字かにかかわらず、SQL記述子域のオクテット長(バイト数)は、1文字を3バイトに換算した値となります。また、UTF-8形式の日本語文字を使用する場合は、1文字を6バイトに換算した値となります。

◆切捨ておよび補正

データベース中の日本語文字の長さは2バイトです。これに対してEUCコードおよびUTF-8形式の日本語文字を使用する場合、ホスト変数の長さは、EUCコードは3バイトであり、UTF-8形式は6バイトです。このため、ホスト変数に日本語文字を設定する、または設定される場合は、日本語文字列の切捨ておよび補正が行われます。

ホスト変数へのEUCコードおよびUTF-8形式の日本語文字の設定

ホスト変数からデータベースにデータを格納する場合、ホスト変数に設定する日本語文字列の長さがホスト変数の長さよりも短い場合は、有効文字列以外の領域には、英数字の空白を設定してください。なお、日本語の空白は、有効な文字列とみなします。

ホスト変数に設定されるEUCコードおよびUTF-8形式の日本語文字

データベースからホスト変数にデータを格納する場合、ホスト変数に設定されるEUCコードおよびUTF-8形式の日本語文字の長さが、ホスト変数の長さよりも短い場合は、有効な文字列以外の領域には英数字の空白が設定されます。