付録 A 日本語専用ライブラリ (libjapanese.a)

JFP では、日本語固有の処理を行うために、libjapanese.a [「はじめに」でも述べましたが、ここで紹介するインタフェースは、ja (または japanese) ロケール上でのみ動作が保証されます。] が提供されています。この付録では、次の項目について説明します。

libjapanese.a と、これに関連する次のヘッダーファイルは、将来のリリースでは提供されません。新規アプリケーションには、前項までに説明した XPG などの標準関数を使用してください。すでに libjapanese.a を使用しているアプリケーションプログラムは、ソースファイルを使って、ソースの互換性を保つための代替関数とマクロを提供します。 詳細は、SUNWjlibj パッケージに含まれる（Entire インストールにのみ含まれる） /usr/share/src/libjapanese/README を参照してください。

• 日本語専用ライブラリの使い方

• 各関数の簡単な説明と使用例

各関数に関する詳しい説明は、JFP 関係のマニュアルページを参照してください。

概説

JFP には、日本語特有の機能を実現する日本語専用ライブラリが含まれています。

一般に、このライブラリに含まれている関数は、プログラムのロケールがシステムで定義された ja または japanese ロケールに設定されていることを前提としています。したがって、このライブラリの関数と SunOS 標準の国際化関数を併用したプログラムが日本語データに関して一貫した動作をするためには、プログラムの始めに setlocale(3C) 関数が呼び出され、これを通じてプログラムのロケールが適当な日本語ロケールに設定される必要があります。

また、日本語専用ライブラリには、JIS コード、EUC、PC 漢字 (MS 漢字、シフト JIS とも呼ばれるコード間などのコード変換を行う関数も定義されています。

次の関数を使用する場合には、コンパイル時に -ljapaneses オプションを指定して、日本語専用ライブラリをリンクしてください。

cjistosj(), cjistouj(), cujtojis(), cujtosj(), csjtojis(),
csjtouj(), jis7tosj(), jis7touj(), sjtojis7(), ujtojis7(),
jis8tosj(), jis8touj(), sjtojis8(), ujtojis8(), jistosj(),
istouj(), ujtojis(), ujtosj(), sjtojis(), sjtouj, wstrtol(),
wstrtod()

ワイド文字列処理関数

これらの関数のほとんどは、SunOS 5.8 の標準ライブラリlibc のワイド文字列処理関数に基づくマクロです。ここで説明する関数は、過去の日本語システムの日本語用ライブラリ仕様と互換性を保つために提供されています。これらの関数を使用するためには widec.h ではなく、/usr/include/wstring.h を取り込んでください。表 A-1 に、ワイド文字列処理関数 (マクロ) を示します。

次の表 A-2 で示す関数は、国際化機能に基づかない日本語固有の日本語処理を含んでおり、libjapanese で提供されます。

例 A-1 は、このワイド文字列処理関数を使って、標準入力ファイル内の主および補助コードセットで書かれた数の合計を計算するプログラム例です。このプログラムでは、getws(3C) 関数で行単位にファイルを読み込んだ後、wstrpbrk(3X) を操作させて整数を求めています。

例 A-1 ワイド文字列処理関数

sun% cat example1.c
#include <stdio.h>
#include <locale.h>
#include <wstring.h>

main()
{
	int total = 0;
	long token;
	wchar_t wbuf[256];
	wchar_t *wptr;

	static char *number = "0123456789０１２３４５６７８９";
	static wchar_t wnumber[21];

	setlocale(LC_ALL, "");
	if (mbstowcs(wnumber, number, 20) <= 0) {
		printf("数字列が認識できません。¥n");
		exit(1);
	}
	while (getws(wbuf) != NULL) {
		wptr = wbuf;
		while (wptr && *wptr) {
			wptr = wstrpbrk(wptr, wnumber);
			if (wptr) {
				token = wstrtol(wptr, &wptr, 10);
				printf("トークンの値 = [%d]¥n", token);
				total += token;
			}
		}
	}
	printf("合計は %d です。¥n", total);
}
sun% cat 入力ファイル 1
343 34534
３４５３４５ ３４５３４５
３９８５７ ３９８ ５８３４５８９
sun% cc -o example1 example1.c -lw -ljapanese
sun% ./example1 < 入力ファイル 1
トークンの値 = [343]
トークンの値 = [34534]
トークンの値 = [345345]
トークンの値 = [345345]
トークンの値 = [39857]
トークンの値 = [398]
トークンの値 = [5834589]
合計は 6600411 です。
sun%

ワイド文字変換用関数 (jconv)

日本語専用ライブラリは、単一バイト変換関数 (toupper、tolower) と同様の変換関数を JIS X 0208、JIS X 0201、 JIS X 0212 に相当する日本語文字専用に提供しています。さらに、ASCII 文字セットと日本語文字間での変換、区点コード変換など、日本語特有の変換を行う関数も提供しています。これらの関数を使用する場合は /usr/include/jctype.h を取り込んでください。

例 A-2 は、これらのワイド文字変換用関数を使用して、JIS X 0208 のカタカナ文字をひらがな文字に変換するプログラム例です。このプログラム例では、getws(3C) 関数で行単位にファイルを読み込んだ後に、tojhira(3X) 関数を使ってカタカナ文字をひらがな文字に変換しています。

例 A-2 ワイド文字変換用関数

sun% cat example2.c
#include <stdio.h>
#include <locale.h>
#include <jctype.h>

main()
{
        wchar_t         wbuf[1024];
        wchar_t         *wptr, c;

        setlocale(LC_ALL, "");
        while (getws(wbuf) != NULL) {
                wptr = wbuf;
                while (*wptr) {
                        c = tojhira(*wptr++);
                        putwc(c, stdout);
                }
                putchar('¥n');
        }
}
sun% cat input_file2
コレハ、カタカナヲひらがなニ変換スル
サンプルプログラムデス。
「ヴヵヶ」ハ、変換サレマセン。
クリカエシキゴウ - ヾヽ
sun% cc -o example2 example2.c -lw
sun% ./example2 < input_file2
これは、かたかなをひらがなに変換する
さんぷるぷろぐらむです。
「ヴヵヶ」は、変換されません。
くりかえしきごう - ゞゝ
sun%

ワイド文字分類関数 (jctype)

日本語専用ライブラリは、文字の分類機能を提供します。これらの関数を使用する場合は、/usr/include/jctype.h を取り込んでください。

次に、これらのワイド文字分類関数を使用して、JIS X 0208 の英語のアルファベット文字と数字を、ASCII の英語のアルファベットと数字に変換するプログラムを紹介します。このプログラム例では、getws(3C) 関数で行単位にファイルを読み込んだ後に、isjalpha(3X) と isjdigit(3X) でワイド文字を分類し、jistoa(3X) 関数を使って ASCII に変換しています。

例 A-3 ワイド文字分類関数

sun% cat example3.c
#include <stdio.h>
#include <locale.h>
#include <jctype.h>

main()
{
        wchar_t         wbuf[1024];
        wchar_t         *wptr;

        setlocale(LC_ALL, "");
        while (getws(wbuf) != NULL) {
                wptr = wbuf;
                while (*wptr) {
                        if (isjdigit(*wptr) || isjalpha(*wptr)){
                                printf(%"wc", jistoa(*wptr));
                        }else {
                                printf(%"wc", *wptr);
                        }
                        *wptr++;
                }
                putchar('¥n');
        }
}
sun% cat input_file3
Ｓｕｎ Ｍｉｃｒｏｓｙｓｔｅｍｓ
０１２３４５６７８９
sun% cc -o example3 example3.c -lw -ljapanese
sun% ./example3 < input_file3
Sun Microsystems
0123456789
sun%

コード変換用関数 (jisconv、ibmjcode)

日本語専用ライブラリは、JIS X 0208 文字集合のコード変換機能を提供します。これらの関数は、JIS X 0208 (jis)、日本語 EUC コード (uj)、PC 漢字コード (sj) 間でコード変換を行います。これらの関数を使用する場合は、/usr/include/jcode.h を取り込んでください。cjistosj(3X) や cujtosj(3X) などの 1 文字コード変換用関数は、JIS X 0208 の漢字セットと JIS X 0201 のアルファベット文字またはかな文字のセットで定義され、JIS X 0208-1983 文字セットの指示は「ESC$B」、JIS X 0201-1976 文字セットの指示は「ESC (J」のシーケンスによって行われます。

例 A-4 は、このコード変換用関数を使って、EUC から JIS コードへコード変換するプログラム例です。

例 A-4 コード変換用関数

sun% cat example4.c
#include <stdio.h>
#include <jcode.h>

main()
{
	char inbuf[2048];
	char outbuf[2048];

		while(gets(inbuf) != NULL) {
			ujtojis(outbuf, inbuf);
			puts(outbuf);
	}
}
sun% cc -o example4 example4.c -ljapanese
sun% cat 入力ファイル4
これは、コード変換のテスト用に作成したファイルです。
いかがでしょう。
sun% ./example4 < 入力ファイル4 | jistoeuc
これは、コード変換のテスト用に作成したファイルです。
いかがでしょう。
sun%

IBM 漢字コードと日本語 EUC コード間のコード変換を行う一連の関数も提供されています (ibmjcode(3X) 参照)。これらの関数を使用する場合は、/usr/include/ibmjcode.h を取り込んでください。