[ 前のページ ] [ 次のページ ] [ 目次 ] [ 索引 ] [ 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

次の文字の文字位置の入手

<形式>

next-ptr = JSY$CH_NEXT ( char-ptr )

<引数>

char-ptr
 JSY usage:文字の1バイト目を指すポインタ
 mechanism :Value渡し

<戻り値>

next-ptr 1文字次の文字の1バイト目を指すポインタ

例)

     #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

前の文字の文字位置の入手

<形式>

prev-ptr = JSY$CH_PREV ( top-ptr, char-ptr )

<引数>

top-ptr
 JSY usage :文字列の先頭を指すポインタ
 mechanism :Value渡し
char-ptr
 JSY usage :文字の1バイト目を指すポインタ
 mechanism :Value渡し

<戻り値>

prev-ptr 1文字前の文字の1バイト目を指すポインタ
char- ptr ≦ top-ptr の場合は0

JSY$CH_CURR

現在の文字の文字位置の入手

<形式>

curr-ptr = JSY$CH_CURR ( top-ptr, char-ptr )

<引数>

top-ptr
 JSY usage :文字列の先頭を指すポインタ
 mechanism :Value渡し
char-ptr
 JSY usage :文字の1バイト目または2バイト目を指すポインタ
 mechanism :Value渡し

<戻り値>

curr-ptr 文字の1バイト目を指すポインタ
char-ptr < top-ptr の場合は0

JSY$POS_NEXT

次の文字の文字位置の入手,および文字列の終わりのチェック

<形式>

next-ptr = JSY$POS_NEXT ( char-ptr, end-ptr )

<引数>

char-ptr
 JSY usage :文字の1バイト目を指すポインタ
 mechanism :Value渡し
end-ptr
 JSY usage :文字列の終わりを示すポインタ
 mechanism :Value渡し

<戻り値>

next-ptr 1文字次の文字の1バイト目を指すポインタ
char- ptr ≧ end-ptr の場合は 0

JSY$POS_PREV

前の文字の文字位置の入手,および文字列の終わりのチェック

<形式>

prev-ptr = JSY$POS_PREV ( top-ptr, char-ptr, end-ptr )

<引数>

top-ptr
 JSY usage :文字列の先頭を指すポインタ
 mechanism :Value渡し
char-ptr
 JSY usage :文字の1バイト目を指すポインタ
 mechanism :Value渡し
end-ptr
 JSY usage :文字列の終わりを示すポインタ
 mechanism :Value渡し

<戻り値>

prev-ptr 1文字前の文字の1バイト目を指すポインタ

例)

     #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

現在の文字の文字位置の入手,および文字列の終わりのチェック

<形式>

curr-ptr = JSY$POS_CURR ( top-ptr, char-ptr, end-ptr )

<引数>

top-ptr
 JSY usage :文字列の先頭を指すポインタ
 mechanism :Value渡し
char-ptr
 JSY usage :文字の1バイト目または2バイト目を指すポインタ
 mechanism :Value渡し
end-ptr
 JSY usage :文字列の終わりを示すポインタ
 mechanism :Value渡し

<戻り値>

curr-ptr 文字の1バイト目を指すポインタ
char-ptr < top-ptr または char-ptr ≧ end-ptr の場合は0

JSY$CH_RCHAR

文字列からの文字の取り出し

<形式>

char-code = JSY$CH_RCHAR ( char-ptr )

<引数>

char-ptr
 JSY usage :文字の1バイト目を指すポインタ
 mechanism :Value渡し

<戻り値>

char-code ポインタが指している文字の文字コード

JSY$CH_RNEXT

文字列からの文字の取り出し,およびポインタの更新

<形式>

char-code = JSY$CH_RNEXT ( char-ptr )

<引数>

char-ptr
 JSY usage :文字の1バイト目を指すポインタ
 mechanism :Reference渡し

<戻り値>

char-code ポインタが指している文字の文字コード

JSY$CH_WCHAR

文字列への文字の書き込み

<形式>

JSY$CH_WCHAR ( char-code, char-ptr )

<引数>

char-code
 JSY usage :文字コード
 mechanism :Value渡し
char-ptr
 JSY usage :文字の1バイト目を指すポインタ
 mechanism :Value渡し

JSY$CH_WNEXT

文字列への文字の書き込みおよびポインタの更新

<形式>

JSY$CH_WNEXT ( char-code, char-ptr )

<引数>

char-code
 JSY usage :文字コード
 mechanism :Value渡し
char-ptr
 JSY usage :文字の1バイト目を指すポインタ
 mechanism :Reference渡し

JSY$CH_GCHAR

文字列からの文字の取り出し,および文字列の終わりのチェック

<形式>

char-code = JSY$CH_GCHAR ( char-ptr, end-ptr )

<引数>

char-ptr
 JSY usage :文字の1バイト目を指すポインタ
 mechanism :Value渡し
end-ptr
 JSY usage :文字列の終わりを示すポインタ
 mechanism :Value渡し

<戻り値>

char-code ポインタが指している文字の文字コード
文字列の終わりをこえていた場合は'FFFF'(16進)

JSY$CH_GNEXT

文字列からの文字の取り出し,ポインタの更新,および文字列の終わりのチェック

<形式>

char-code = JSY$CH_GNEXT ( char-ptr, end-ptr )

<引数>

char-ptr
 JSY usage :文字の1バイト目を指すポインタ
 mechanism :Reference渡し
end-ptr
 JSY usage :文字列の終わりを示すポインタ
 mechanism :Value渡し

<戻り値>

char-code ポインタが指している文字の文字コード
文字列の終わりをこえていた場合は'FFFF'(16進)

JSY$CH_PCHAR

文字列への文字の書き込み,および文字列の終わりのチェック

<形式>

status = JSY$CH_PCHAR ( char-code, char-ptr, end-ptr )

<引数>

char-code
 JSY usage :文字コード
 mechanism :Value渡し
char-ptr
 JSY usage :文字の1バイト目を指すポインタ
 mechanism :Value渡し
end-ptr
 JSY usage :文字列の終わりを示すポインタ
 mechanism :Value渡し

<戻り値>

status 1 : 文字の書き込みができた場合
0 : 文字の書き込みができなかった場合
(end- ptr をこえた)

JSY$CH_PNEXT

文字列への文字の書き込み,ポインタの更新,および文字列の終わりのチェック

<形式>

status = JSY$CH_PNEXT ( char-code, char-ptr, end-ptr )

<引数>

char-code
 JSY usage :文字コード
 mechanism :Value渡し
char-ptr
 JSY usage :文字の1バイト目を指すポインタ
 mechanism :Reference渡し
end-ptr
 JSY usage :文字列の終わりを示すポインタ
 mechanism :Value渡し

<戻り値>

status 1 : 文字の書き込みができた場合
0 : 文字の書き込みができなかった場合
(end- ptr をこえた)

例)

     #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

文字が占めるバイト数の入手

<形式>

nof-byte = JSY$CH_SIZE ( char-code )

<引数>

char-code
 JSY usage :文字コード
 mechanism :Value渡し

<戻り値>

nof-byte 文字コードが255以下の場合は1,256以上の場合は2

JSY$CH_NBYTE

文字列が占めるバイト数の入手

<形式>

nof-byte = JSY$CH_NBYTE ( top-ptr, nof-char )

<引数>

top-ptr
 JSY usage :文字列の先頭を指すポインタ
 mechanism :Value渡し
nof-char
 JSY usage :文字数
 mechanism :Value渡し

<戻り値>

nof-byte top-ptrからnof-char文字が占めるバイト数

JSY$CH_NCHAR

文字列に含まれる文字数の入手

<形式>

nof-char = JSY$CH_NCHAR ( top-ptr, nof-byte )

<引数>

top-ptr
 JSY usage :文字列の先頭を指すポインタ
 mechanism :Value渡し
nof-byte
 JSY usage :バイト数
 mechanism :Value渡し

<戻り値>

nof-char top-ptrからnof-byteバイト内にある文字数

JSY$POSITION

文字列の検索

<形式>

address = JSY$POSITION ( src-str, src-len, sub-str, sub-len )

<引数>

src-str
 JSY usage :検索される文字列の先頭を指すポインタ
 mechanism :Value渡し
src-len
 JSY usage :検索される文字列のバイト長
 mechanism :Value渡し
sub-str
 JSY usage :検索する文字列の先頭を指すポインタ
 mechanism :Value渡し
sub-len
 JSY usage :検索する文字列のバイト長
 mechanism :Value渡し

<戻り値>

address 検索する文字列が含まれていた場合は文字列の先頭アドレス
文字列が含まれていなければ 0

JSY$STR_EQUAL

英大文字/小文字,全角/半角,ひらがな/カタカナ変換による文字列の比較

<形式>

status = JSY$STR_EQUAL ( str1, len1, str2, len2, flg )

<引数>

str1
 JSY usage :比較対象文字列1の先頭を指すポインタ
 mechanism :Value渡し
len1
 JSY usage :比較対象文字列1のバイト長
 mechanism :Value渡し
str2
 JSY usage :比較対象文字列2の先頭を指すポインタ
 mechanism :Value渡し
len2
 JSY usage :比較対象文字列2のバイト長
 mechanism :Value渡し
flg
 JSY usage :変換フラグ
比較の前に行う変換を指定する。
bit 0 0 : 英大文字/小文字変換を行う
1 : 英大文字/小文字変換を行わない
bit 1 0 : 全角/半角変換を行う
1 : 全角/半角変換を行わない
bit 2 0 : ひらがな/カタカナ変換を行う
1 : ひらがな/カタカナ変換を行わない
 mechanism :Value渡し

<戻り値>

ret-code 1 : 文字列1と文字列2が等しい
0 : 文字列1と文字列2が等しくない

JSY$STR_START

英大文字/小文字,全角/半角,ひらがな/カタカナ変換による文字列の比較
文字列1が文字列2で始まっているかどうかを調べる。

<形式>

status = JSY$STR_START ( str1, len1, str2, len2, flg )

<引数>

str1
 JSY usage :比較対象文字列1の先頭を指すポインタ
 mechanism :Value渡し
len1
 JSY usage :比較対象文字列1のバイト長
 mechanism :Value渡し
str2
 JSY usage :比較対象文字列2の先頭を指すポインタ
 mechanism :Value渡し
len2
 JSY usage :比較対象文字列2のバイト長
 mechanism :Value渡し
flg
 JSY usage :変換フラグ
比較の前に行う変換を指定する。
bit 0 0 : 英大文字/小文字変換を行う
1 : 英大文字/小文字変換を行わない
bit 1 0 : 全角/半角変換を行う
1 : 全角/半角変換を行わない
bit 2 0 : ひらがな/カタカナ変換を行う
1 : ひらがな/カタカナ変換を行わない
 mechanism :Value渡し

<戻り値>

ret-code 1 : 文字列1が文字列2で始まっている
0 : 文字列1が文字列2で始まっていない

JSY$STR_SEARCH

英大文字/小文字,全角/半角,ひらがな/カタカナ変換による文字列の検索

<形式>

address = JSY$STR_SEARCH ( src-str, src-len, sub-str, sub-len, flg )

<引数>

src-str
 JSY usage :検索される文字列の先頭を指すポインタ
 mechanism :Value渡し
src-len
 JSY usage :検索される文字列のバイト長
 mechanism :Value渡し
sub-str
 JSY usage :検索する文字列の先頭を指すポインタ
 mechanism :Value渡し
sub-len
 JSY usage :検索する文字列のバイト長
 mechanism :Value渡し
flg
 JSY usage :変換フラグ
検索の前に行う変換を指定する。
bit 0 0 : 英大文字/小文字変換を行う
1 : 英大文字/小文字変換を行わない
bit 1 0 : 全角/半角変換を行う
1 : 全角/半角変換を行わない
bit 2 0 : ひらがな/カタカナ変換を行う
1 : ひらがな/カタカナ変換を行わない
 mechanism :Value渡し

<戻り値>

address 検索する文字列が含まれていた場合は文字列の先頭のアドレス, そうでなければ0

JSY$TRIM

文字列の後の空白の切り捨て

<形式>

res-len = JSY$TRIM ( str, len )

<引数>

str
 JSY usage :文字列の先頭を指すポインタ
 mechanism :Value渡し
len
 JSY usage :文字列のバイト長
 mechanism :Value渡し

<戻り値>

res-len 空白切り捨て後の文字列の長さ

JSY$TRUNC

指定された長さでの文字列の切り捨て

<形式>

res-len = JSY$TRUNC ( str, len, trunc-len )

<引数>

str
 JSY usage :文字列の先頭を指すポインタ
 mechanism :Value渡し
len
 JSY usage :文字列のバイト長
 mechanism :Value渡し
trunc-len
 JSY usage :切り捨てを行うバイト長
 mechanism :Value渡し

<戻り値>

res-len 切り捨て後の文字列の長さ

JSY$LOCC

文字の検索

<形式>

address = JSY$LOCC ( char-code, str, len )

<引数>

char-code
 JSY usage :検索する文字コード
 mechanism :Value渡し
str
 JSY usage :文字列の先頭を指すポインタ
 mechanism :Value渡し
len
 JSY usage :文字列のバイト長
 mechanism :Value渡し

<戻り値>

address 検索する文字が含まれていた場合はそのアドレス文字が含まれていなければ0

JSY$SKPC

文字の飛び越し

<形式>

address = JSY$SKPC ( char-code, str, len )

<引数>

char-code
 JSY usage :飛び越しする文字コード
 mechanism :Value渡し
str
 JSY usage :文字列の先頭を指すポインタ
 mechanism :Value渡し
len
 JSY usage :文字列のバイト長
 mechanism :Value渡し

<戻り値>

address 飛び越しする文字以外の文字がある場合はそのアドレスすべて飛び越す文字と同じであれば0

4.3 文字変換ルーチン

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

JSY$CHG_ROM_HALF

ローマ文字全角から半角への変換

<形式>

res-code = JSY$CHG_ROM_HALF ( char-code )

<引数>

char-code
 JSY usage :文字コード
 mechanism :Value渡し

<戻り値>

res-code 変換後の文字コード

JSY$CHG_ROM_FULL

ローマ文字半角から全角への変換

<形式>

res-code = JSY$CHG_ROM_FULL ( char-code )

<引数>

char-code
 JSY usage :文字コード
 mechanism :Value渡し

<戻り値>

res-code 変換後の文字コード

JSY$CHG_ROM_SIZE

ローマ文字全角/半角の相互変換

<形式>

res-code = JSY$CHG_ROM_SIZE ( char-code )

<引数>

char-code
 JSY usage :文字コード
 mechanism :Value渡し

<戻り値>

res-code 変換後の文字コード

JSY$CHG_ROM_LOWER

英文字半角/全角の小文字への変換

<形式>

res-code = JSY$CHG_ROM_LOWER ( char-code )

<引数>

char-code
 JSY usage :文字コード
 mechanism :Value渡し

<戻り値>

res-code 変換後の文字コード

JSY$CHG_ROM_UPPER

英文字半角/全角の大文字への変換

<形式>

res-code = JSY$CHG_ROM_UPPER ( char-code )

<引数>

char-code
 JSY usage :文字コード
 mechanism :Value渡し

<戻り値>

res-code 変換後の文字コード

JSY$CHG_ROM_CASE

英文字全角/半角の大文字/小文字の相互変換

<形式>

res-code = JSY$CHG_ROM_CASE ( char-code )

<引数>

char-code
 JSY usage :文字コード
 mechanism :Value渡し

<戻り値>

res-code 変換後の文字コード

JSY$CHG_KANA_HIRA

全角カタカナから全角ひらがなへの変換

<形式>

res-code = JSY$CHG_KANA_HIRA ( char-code )

<引数>

char-code
 JSY usage :文字コード
 mechanism :Value渡し

<戻り値>

res-code 変換後の文字コード

JSY$CHG_KANA_KATA

全角ひらがなから全角カタカナへの変換

<形式>

res-code = JSY$CHG_KANA_KATA ( char-code )

<引数>

char-code
 JSY usage :文字コード
 mechanism :Value渡し

<戻り値>

res-code 変換後の文字コード

JSY$CHG_KANA_KANA

全角ひらがな/全角カタカナの相互変換

<形式>

res-code = JSY$CHG_KANA_KANA ( char-code )

<引数>

char-code
 JSY usage :文字コード
 mechanism :Value渡し

<戻り値>

res-code 変換後の文字コード

JSY$CHG_KANA_DAKU

全角ひらがな/カタカナの濁点/半濁点処理

<形式>

status = JSY$CHG_KANA_DAKU ( char-code, ten-code, res-code )

<引数>

char-code
 JSY usage :かな文字コード
 mechanism:Value渡し
ten-code
 JSY usage :濁点/半濁点文字コード
 mechanism :Value渡し
res-code
 JSY usage :変換後の文字コード
   変換が行われた場合は変換後の文字コード
   変換が行われなかった場合はten-codeの値
 type :Longword
 mechanism :Reference渡し

<戻り値>

status 1 : 変換が行われた
  0 : 変換が行われなかった

JSY$CHG_KANA_HALF

全角ひらがな/カタカナから半角カタカナへの変換

<形式>

status = JSY$CHG_KANA_HALF ( char-code, dst-str, res-len )

<引数>

char-code
 JSY usage :かな文字コード
 mechanism :Value渡し
dst-str
 JSY usage :変換結果出力領域の先頭を指すポインタ
 mechanism :Value渡し
res-len
 JSY usage :変換結果のバイト長
 type :Longword
 mechanism :Reference渡し

<戻り値>

status 1 : 変換が行われた
0 : 変換が行われなかった

JSY$CHG_KANA_FULL

半角カタカナから全角ひらがな/カタカナへの変換

<形式>

res-code = JSY$CHG_KANA_FULL ( char-code, flg )

<引数>

char-code
 JSY usage :文字コード
 mechanism :Value渡し
flg
 JSY usage :変換指示フラグ
  0 : 全角ひらがなへの変換
  1 : 全角カタカナへの変換
 mechanism :Value渡し

<戻り値>

res-code 変換後の文字コード

JSY$CHG_GENERAL

パラメータ指定による,英大文字/小文字,全角/半角,ひらがな/カタカナへの変換

<形式>

res-code = JSY$CHG_GENERAL ( char-code, flg )

<引数>

char-code
 JSY usage :文字コード
 mechanism :Value渡し
flg
 JSY usage :変換フラグ
検索の前に行う変換を指定する
bit 0 0 : 英大文字/小文字変換を行う
1 : 英大文字/小文字変換を行わない
bit 1 0 : 全角/半角変換を行う
1 : 全角/半角変換を行わない
bit 2 0 : ひらがな/カタカナ変換を行う
1 : ひらがな/カタカナ変換を行わない
 mechanism :Value渡し

<戻り値>

res-code 変換後の文字コード

JSY$CHG_JIS_KUTEN

JIS区点番号からDEC漢字コードへの変換
区点番号 101〜9494 DEC漢字セット
10101〜19494 拡張領域

<形式>

res-code = JSY$CHG_JIS_KUTEN ( kuten-code )

<引数>

kuten-code
 JSY usage :区点番号
 mechanism :Value渡し

<戻り値>

res-code 変換後の文字コード

JSY$CHG_KEISEN

数字から罫線文字への変換

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

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

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

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

<形式>

res-code = JSY$CHG_KEISEN ( char-code )

<引数>

char-code
 JSY usage :文字コード
 mechanism :Value渡し

<戻り値>

res-code 変換後の文字コード

4.4 文字列変換ルーチン

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

JSY$TRA_ROM_HALF

ローマ文字全角から半角への変換

<形式>

status = JSY$TRA_ROM_HALF ( src-str, src-len, dst-str, dst-len, out-len )

<引数>

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渡し

<戻り値>

status 1 : 正常終了
0 : 出力結果の切り捨てが行われた

JSY$TRA_ROM_FULL

ローマ文字半角から全角への変換

<形式>

status = JSY$TRA_ROM_FULL ( src-str, src-len, dst-str, dst-len, out-len )

<引数>

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渡し

<戻り値>

status 1 : 正常終了
0 : 出力結果の切り捨てが行われた

JSY$TRA_ROM_SIZE

ローマ文字全角/半角の相互変換

<形式>

status = JSY$TRA_ROM_SIZE ( src-str, src-len, dst-str, dst-len, out-len )

<引数>

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渡し

<戻り値>

status 1 : 正常終了
0 : 出力結果の切り捨てが行われた

JSY$TRA_ROM_LOWER

英文字半角/全角の小文字への変換

<形式>

status = JSY$TRA_ROM_LOWER ( src-str, src-len, dst-str, dst-len, out-len )

<引数>

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渡し

<戻り値>

status 1 : 正常終了
0 : 出力結果の切り捨てが行われた

JSY$TRA_ROM_UPPER

英文字半角/全角の大文字への変換

<形式>

status = JSY$TRA_ROM_UPPER ( src-str, src-len, dst-str, dst-len, out-len )

<引数>

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渡し

<戻り値>

status 1 : 正常終了
0 : 出力結果の切り捨てが行われた

JSY$TRA_ROM_CASE

英文字全角/半角の大文字/小文字の相互変換

<形式>

status = JSY$TRA_ROM_CASE ( src-str, src-len, dst-str, dst-len, out-len )

<引数>

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渡し

<戻り値>

status 1 : 正常終了
0 : 出力結果の切り捨てが行われた

JSY$TRA_ROM_KANA

ローマ字から全角ひらがな/カタカナへの変換

<形式>

status = JSY$TRA_ROM_KANA ( src-str, src-len, flg, dst-str, dst-len, out-len )

<引数>

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渡し

<戻り値>

status 1 : 正常終了
0 : 出力結果の切り捨てが行われた

JSY$TRA_KANA_HIRA

全角カタカナから全角ひらがなへの変換

<形式>

status = JSY$TRA_KANA_HIRA ( src-str, src-len, dst-str, dst-len, out-len )

<引数>

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渡し

<戻り値>

status 1 : 正常終了
0 : 出力結果の切り捨てが行われた

JSY$TRA_KANA_KATA

全角ひらがなから全角カタカナへの変換

<形式>

status = JSY$TRA_KANA_KATA ( src-str, src-len, dst-str, dst-len, out-len )

<引数>

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渡し

<戻り値>

status 1 : 正常終了
0 : 出力結果の切り捨てが行われた

JSY$TRA_KANA_KANA

全角ひらがな/全角カタカナの相互変換

<形式>

status = JSY$TRA_KANA_KANA ( src-str, src-len, dst-str, dst-len, out-len )

<引数>

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渡し

<戻り値>

status 1 : 正常終了
0 : 出力結果の切り捨てが行われた

JSY$TRA_KANA_DAKU

全角ひらがな/カタカナの濁点/半濁点処理

<形式>

status = JSY$TRA_KANA_DAKU ( src-str, src-len, dst-str, dst-len, out-len )

<引数>

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渡し

<戻り値>

status 1 : 正常終了
0 : 出力結果の切り捨てが行われた

JSY$TRA_KANA_HALF

全角ひらがな/カタカナから半角カタカナへの変換

<形式>

status = JSY$TRA_KANA_HALF ( src-str, src-len, dst-str, dst-len, out-len )

<引数>

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渡し

<戻り値>

status 1 : 正常終了
0 : 出力結果の切り捨てが行われた

JSY$TRA_KANA_FULL

半角カタカナから全角ひらがな/カタカナへの変換

<形式>

status = JSY$TRA_KANA_FULL ( src-str, src-len, flg, dst-str, dst-len, out-len )

<引数>

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

<戻り値>

status 1 : 正常終了
0 : 出力結果の切り捨てが行われた

JSY$TRA_SYMBOL

記号変換

<形式>

status = JSY$TRA_SYMBOL ( src-str, src-len, dst-str, dst-len, out-len )

<引数>

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

<戻り値>

status 1 : 正常終了
0 : 出力結果の切り捨てが行われた


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