[ 前のページ ] [ 次のページ ] [ 目次 ] [ 索引 ] [ DOC Home ]

4 基本ライブラリ

この章では，基本ライブラリについて説明します。

基本ライブラリとは

1文字単位の変換など，より細かな処理を行うためのルーチン群です。

4.1 基本ライブラリ・ルーチン一覧

日本語文字列操作ルーチン

日本語データを扱うための基本的なルーチン群です。 1バイト/2バイトの文字コードを正しく取り扱うために使用します。

JSY$CH_NEXT	次の文字の文字位置の入手
JSY$CH_PREV	前の文字の文字位置の入手
JSY$CH_CURR	現在の文字の文字位置の入手
JSY$POS_ NEXT	次の文字の文字位置の入手，および文字列の終わりのチェック
JSY$POS_ PREV	前の文字の文字位置の入手，および文字列の終わりのチェック
JSY$POS_ CURR	現在の文字の文字位置の入手，および文字列の終わりのチェック
JSY$CH_ RCHAR	文字列からの文字の取り出し
JSY$CH_RNEXT	文字列からの文字の取り出し
JSY$CH_WCHAR	文字列への文字の書き込み
JSY$CH_WNEXT	文字列への文字の書き込み
JSY$CH_ GCHAR	文字列からの文字の取り出し，および文字列の終わりのチェック
JSY$CH_ GNEXT	文字列からの文字の取り出し，および文字列の終わりのチェック
JSY$CH_ PCHAR	文字列への文字の書き込み，および文字列の終わりのチェック
JSY$CH_ PNEXT	文字列への文字の書き込み，および文字列の終わりのチェック
JSY$CH_ SIZE	文字が占めるバイト数の入手
JSY$CH_NBYTE	文字列が占めるバイト数の入手
JSY$CH_NCHAR	文字列に含まれる文字数の入手
JSY$POSITION	文字列の検索
JSY$STR_EQUAL	英大文字/小文字，全角/半角，ひらがな/カタカナ変換による文字列の比較
JSY$STR_START	英大文字/小文字，全角/半角，ひらがな/カタカナ変換による文字列の比較
JSY$STR_SEARCH	英大文字/小文字，全角/半角，ひらがな/カタカナ変換による文字列の検索
JSY$TRIM	文字列の後の空白の切り捨て
JSY$TRUNC	文字列の切り捨て
JSY$LOCC	文字の検索
JSY$SKPC	文字の飛び越し

文字変換ルーチン

文字単位の各種変換を行うルーチン群です。

JSY$CHG_ROM_HALF	ローマ文字全角から半角への変換
JSY$CHG_ROM_FULL	ローマ文字半角から全角への変換
JSY$CHG_ROM_SIZE	ローマ文字全角/半角の相互変換
JSY$CHG_ROM_LOWER	英文字半角/全角の小文字への変換
JSY$CHG_ROM_UPPER	英文字半角/全角の大文字への変換
JSY$CHG_ROM_CASE	英文字全角/半角の大文字/小文字の相互変換
JSY$CHG_KANA_HIRA	全角カタカナから全角ひらがなへの変換
JSY$CHG_KANA_KATA	全角ひらがなから全角カタカナへの変換
JSY$CHG_KANA_KANA	全角ひらがな/全角カタカナの相互変換
JSY$CHG_KANA_DAKU	全角ひらがな/カタカナの濁点/半濁点処理
JSY$CHG_KANA_HALF	全角ひらがな/カタカナから半角カタカナへの変換
JSY$CHG_KANA_ FULL	半角カタカナから全角ひらがな/カタカナへの変換
JSY$CHG_GENERAL	パラメータ指定による，英大文字/小文字， 全角/半角，ひらがな/カタカナ
JSY$CHG_JIS_KUTEN	JIS区点番号からDEC漢字コードへの変換
JSY$CHG_KEISEN	数字から罫線文字への変換

文字列変換ルーチン

文字列の各種変換を行うルーチン群です。

JSY$TRA_ROM_HALF	ローマ文字全角から半角への変換
JSY$TRA_ROM_FULL	ローマ文字半角から全角への変換
JSY$TRA_ROM_SIZE	ローマ文字全角/半角の相互変換
JSY$TRA_ROM_LOWER	英文字半角/全角の小文字への変換
JSY$TRA_ROM_ UPPER	英文字半角/全角の大文字への変換
JSY$TRA_ROM_CASE	英文字全角/半角の大文字/小文字の相互変換
JSY$TRA_ ROM_KANA	ローマ字から全角ひらがな/カタカナへの変換
JSY$TRA_KANA_HIRA	全角カタカナから全角ひらがなへの変換
JSY$TRA_KANA_KATA	全角ひらがなから全角カタカナへの変換
JSY$TRA_KANA_KANA	全角ひらがな/全角カタカナの相互変換
JSY$TRA_KANA_DAKU	全角ひらがな/カタカナの濁点/半濁点処理
JSY$TRA_KANA_HALF	全角ひらがな/カタカナから半角カタカナへの変換
JSY$TRA_KANA_FULL	半角カタカナから全角ひらがな/カタカナへの変換
JSY$TRA_ SYMBOL	記号変換

4.2 日本語文字列操作ルーチン

日本語データを扱うための基本的なルーチン群です。 1バイト/2バイトの文字コードを正しく取り扱うために使用します。

JSY$CH_NEXT

＜形式＞

＜引数＞

＜戻り値＞

例)

     #include <stdio.h>
     #include <string.h>

     static void     create_display_string();

     main()
     {
         char        *char_ptr,
                     *next_ptr;
         char        string[] = "日本語RTL";
         char        disp_str[32];
         int         byte_offset = 4;
         extern char *jsy$ch_next();

         char_ptr = string + byte_offset;

         printf( "文字列 :\"%s\"\n", string );
         create_display_string( char_ptr, disp_str );
         printf( "実行前の位置の文字 :%s\n", disp_str );

         next_ptr = jsy$ch_next( char_ptr );
         create_display_string( next_ptr, disp_str );
         printf( "実行後の位置の文字 :%s\n", disp_str );
     }

     static void     create_display_string(src, disp)
     char    *src;
     char    *disp;
     {
         int nof_byte_char = 1;
         unsigned char       check;

         check = (unsigned char)(*src);
         if ( ( 0x0A1 <= check ) && ( check <= 0x0FE ) )     /* 範囲内なら2バイト文字 */
             nof_byte_char = 2;

         strncpy( disp, src, nof_byte_char );
         disp[ nof_byte_char ] = '\0';
     }

JSY$CH_PREV

＜形式＞

＜引数＞

＜戻り値＞

JSY$CH_CURR

＜形式＞

＜引数＞

＜戻り値＞

JSY$POS_NEXT

＜形式＞

＜引数＞

＜戻り値＞

JSY$POS_PREV

＜形式＞

＜引数＞

＜戻り値＞

例)

     #include <stdio.h>
     #include <string.h>

     #define MSB     0x80

     static void     create_display_string();

     main()
     {
         char        *top_ptr,
                     *char_ptr,
                     *end_ptr,
                     *prev_ptr;
         char        string[] = "日本語RTL";
         char        disp_str[32];
         int         byte_offset = 6;
         extern char *jsy$pos_prev();

         top_ptr = string;
         end_ptr = string + strlen( string );
         char_ptr = string + byte_offset;

         create_display_string( char_ptr, disp_str );
         printf( "文字列 :\"%s\"\n", string );
         printf( "実行前の位置の文字 :%s\n", disp_str );

         prev_ptr = jsy$pos_prev( top_ptr, char_ptr, end_ptr );

         create_display_string( prev_ptr, disp_str );
         printf( "実行後の位置の文字 :%s\n", disp_str );
     }

     static void     create_display_string(src, disp)
     char    *src;
     char    *disp;
     {
         int nof_byte_char = 1;
         unsigned char       check;

         check = (unsigned char)(*src);
         if ( ( 0x0A1 <= check ) && ( check <= 0x0FE ) )     /* 範囲内なら2バイト文字 */
             nof_byte_char = 2;

         strncpy( disp, src, nof_byte_char );
         disp[ nof_byte_char ] = '\0';
     }

JSY$POS_CURR

＜形式＞

＜引数＞

＜戻り値＞

JSY$CH_RCHAR

＜形式＞

＜引数＞

＜戻り値＞

JSY$CH_RNEXT

＜形式＞

＜引数＞

＜戻り値＞

JSY$CH_WCHAR

＜形式＞

＜引数＞

JSY$CH_WNEXT

＜形式＞

＜引数＞

JSY$CH_GCHAR

＜形式＞

＜引数＞

＜戻り値＞

JSY$CH_GNEXT

＜形式＞

＜引数＞

＜戻り値＞

JSY$CH_PCHAR

＜形式＞

＜引数＞

＜戻り値＞

JSY$CH_PNEXT

＜形式＞

＜引数＞

＜戻り値＞

例)

     #include <stdio.h>
     #include <string.h>

     #define ENCODE( c )\
      ( ( ( ( c ) & 0xff ) << 8 ) |( ( ( c ) & 0xff00 ) >> 8 ) )

     static void     create_display_string();

     main()
     {
         unsigned short int  char_code;
         char        *char_ptr,
                     *end_ptr;
         int         status;
         int         byte_offset = 4;
         char        string[] = "実行前の文字列";
         char        disp_str[32];
         extern int  jsy$ch_pnext();

         char_code = ENCODE( '後' );
         char_ptr = string + byte_offset;
         end_ptr = string + strlen( string );

         printf( "書き込む文字 :%c%c\n",
             ( char_code & 0xff00 ) >> 8, char_code & 0xff );
         create_display_string( char_ptr, disp_str );
         printf( "実行前の文字列 :\"%s\"    実行前の位置の文字 :%s\n",
             string, disp_str );

         status = jsy$ch_pnext( char_code, &char_ptr, end_ptr );

         create_display_string( char_ptr, disp_str );
         printf( "実行後の文字列 :\"%s\"    実行後の位置の文字 :%s    ステータス :%1d\n",)
             string, disp_str, status );
     }

     static void     create_display_string(src, disp)
     char    *src;
     char    *disp;
     {
         int nof_byte_char = 1;
         unsigned char       check;

         check = (unsigned char)(*src);
         if ( ( 0x0A1 <= check ) && ( check <= 0x0FE ) )     /* 範囲内なら2バイト文字 */
             nof_byte_char = 2;

         strncpy( disp, src, nof_byte_char );
         disp[ nof_byte_char ] = '\0';
     }

JSY$CH_SIZE

＜形式＞

＜引数＞

＜戻り値＞

JSY$CH_NBYTE

＜形式＞

＜引数＞

＜戻り値＞

JSY$CH_NCHAR

＜形式＞

＜引数＞

＜戻り値＞

JSY$POSITION

＜形式＞

＜引数＞

＜戻り値＞

JSY$STR_EQUAL

＜形式＞

＜引数＞

＜戻り値＞

JSY$STR_START

＜形式＞

＜引数＞

＜戻り値＞

JSY$STR_SEARCH

＜形式＞

＜引数＞

＜戻り値＞

JSY$TRIM

＜形式＞

＜引数＞

＜戻り値＞

JSY$TRUNC

＜形式＞

＜引数＞

＜戻り値＞

JSY$LOCC

＜形式＞

＜引数＞

＜戻り値＞

JSY$SKPC

＜形式＞

＜引数＞

＜戻り値＞

4.3 文字変換ルーチン

文字単位の各種変換を行うルーチン群です。

JSY$CHG_ROM_HALF

＜形式＞

＜引数＞

＜戻り値＞

JSY$CHG_ROM_FULL

＜形式＞

＜引数＞

＜戻り値＞

JSY$CHG_ROM_SIZE

＜形式＞

＜引数＞

＜戻り値＞

JSY$CHG_ROM_LOWER

＜形式＞

＜引数＞

＜戻り値＞

JSY$CHG_ROM_UPPER

＜形式＞

＜引数＞

＜戻り値＞

JSY$CHG_ROM_CASE

＜形式＞

＜引数＞

＜戻り値＞

JSY$CHG_KANA_HIRA

＜形式＞

＜引数＞

＜戻り値＞

JSY$CHG_KANA_KATA

＜形式＞

＜引数＞

＜戻り値＞

JSY$CHG_KANA_KANA

＜形式＞

＜引数＞

＜戻り値＞

JSY$CHG_KANA_DAKU

＜形式＞

＜引数＞

＜戻り値＞

JSY$CHG_KANA_HALF

＜形式＞

＜引数＞

＜戻り値＞

JSY$CHG_KANA_FULL

＜形式＞

＜引数＞

＜戻り値＞

JSY$CHG_GENERAL

＜形式＞

＜引数＞

＜戻り値＞

JSY$CHG_JIS_KUTEN

＜形式＞

＜引数＞

＜戻り値＞

JSY$CHG_KEISEN

     '7' → '┌'   '8' → '┬'  '9' → '┐'

     '4' → '├'   '5' → '┼'  '6' → '┤'

     '1' → '└'   '2' → '┴'  '3' → '┘'

     '0' → '│'   '-' → '─'

＜形式＞

＜引数＞

＜戻り値＞

4.4 文字列変換ルーチン

文字列の各種変換を行うルーチン群です。

JSY$TRA_ROM_HALF

＜形式＞

＜引数＞

src-str
	JSY usage	：変換対象文字列の先頭を指すポインタ
	mechanism	：Value渡し
src-len
	JSY usage	：変換対象文字列のバイト長
	mechanism	：Value渡し
dst-str
	JSY usage	：変換結果出力領域の先頭を指すポインタ
	mechanism	：Value渡し
dst-len
	JSY usage	：変換結果出力領域のバイト長
	mechanism	：Value渡し
out-len
	JSYusage	：変換結果のバイト長
	type	：Longword
	mechanism	：Reference渡し

＜戻り値＞

JSY$TRA_ROM_FULL

＜形式＞

＜引数＞

＜戻り値＞

JSY$TRA_ROM_SIZE

＜形式＞

＜引数＞

src-str
	JSY usage	：変換対象文字列の先頭を指すポインタ
	mechanism	：Value渡し
src-len
	JSY usage	：変換対象文字列のバイト長
	mechanism	：Value渡し
dst-str
	JSY usage	：変換結果出力領域の先頭を指すポインタ
	mechanism	：Value渡し
dst-len
	JSY usage	：変換結果出力領域のバイト長
	mechanism	：Value渡し
out-len
	JSYusage	：変換結果のバイト長
	type	：Longword
	mechanism	：Reference渡し

＜戻り値＞

JSY$TRA_ROM_LOWER

＜形式＞

＜引数＞

＜戻り値＞

JSY$TRA_ROM_UPPER

＜形式＞

＜引数＞

src-str
	JSY usage	：変換対象文字列の先頭を指すポインタ
	mechanism	：Value渡し
src-len
	JSY usage	：変換対象文字列のバイト長
	mechanism	：Value渡し
dst-str
	JSY usage	：変換結果出力領域の先頭を指すポインタ
	mechanism	：Value渡し
dst-len
	JSY usage	：変換結果出力領域のバイト長
	mechanism	：Value渡し
out-len
	JSYusage	：変換結果のバイト長
	type	：Longword
	mechanism	：Reference渡し

＜戻り値＞

JSY$TRA_ROM_CASE

＜形式＞

＜引数＞

＜戻り値＞

JSY$TRA_ROM_KANA

＜形式＞

＜引数＞

src-str
	JSY usage	：変換対象文字列の先頭を指すポインタ
	mechanism	：Value渡し
src-len
	JSY usage	：変換対象文字列のバイト長
	mechanism	：Value渡し
flg
	JSY usage	：変換指示フラグ
		bit 0	0 : 全角ひらがなへ変換
			1 : 全角カタカナへ変換
	mechanism	：Value渡し
dst-str
	JSY usage	：変換結果出力領域の先頭を指すポインタ
	mechanism	：Value渡し
dst-len
	JSY usage	：変換結果出力領域のバイト長
	mechanism	：Value渡し
out-len
	JSY usage	：変換結果のバイト長
	type	：Longword
	mechanism	：Reference渡し

＜戻り値＞

JSY$TRA_KANA_HIRA

＜形式＞

＜引数＞

＜戻り値＞

JSY$TRA_KANA_KATA

＜形式＞

＜引数＞

＜戻り値＞

JSY$TRA_KANA_KANA

＜形式＞

＜引数＞

＜戻り値＞

JSY$TRA_KANA_DAKU

＜形式＞

＜引数＞

＜戻り値＞

JSY$TRA_KANA_HALF

＜形式＞

＜引数＞

＜戻り値＞

JSY$TRA_KANA_FULL

＜形式＞

＜引数＞

＜戻り値＞

JSY$TRA_SYMBOL

＜形式＞

＜引数＞

＜戻り値＞