Compaq OpenVMS
Compaq C 国際化ユーティリティ・
リファレンス・マニュアル


前へ 次へ 目次 索引



第 4 章
コマンド・リファレンス

Compaq C ランタイム・ライブラリ・ユーティリティで提供される,次のコマンドとその構文について説明します。


GENCAT

メッセージ・テキスト・ソース・ファイルをメッセージ・カタログ・ファイルにマージします。

形式

GENCAT msgfile[,...] catfile


パラメータ

msgfile

必須。

メッセージ・テキスト・ソース・ファイルの名前。デフォルトのファイル・タイプは .MSGX です。

catfile

必須。

メッセージ・カタログ出力ファイルの名前。 catfile がすでに存在する場合には,既存のカタログのメッセージも含んだ新しいバージョンが作成されます。ファイル・タイプは .CAT でなければなりません。


修飾子

なし


説明

GENCATコマンドは,1つ以上の入力ソース・ファイル,および既存のカタログ・ファイル(ある場合)から,メッセージ・カタログを新しく作成します。メッセージ・カタログは,アプリケーション用のメッセージを含むバイナリ・ファイルです。エラー・メッセージ,画面表示,プロンプトなど,アプリケーションが出力するすべてのメッセージがここに含まれます。アプリケーションは,Cランタイム・ライブラリ・ルーチンの catopencatgets,および catcloseを使用して,メッセージ・カタログからメッセージを検索します。これらのルーチンについての詳細は,『Compaq C Run-Time Library Reference Manual for OpenVMS Systems』を参照してください。

メッセージ・テキスト・ソース・ファイルは,ユーザが作成するテキスト・ファイルであり,ユーザのプログラムから出力されるメッセージをここに入れます。テキスト・ソース・ファイルには,任意のテキスト・エディタで,メッセージを入力できます。メッセージは,通常,プログラムの機能サブセットに相当するセットにグループ化できます。各メッセージは,そのセット内で一意の数字の識別子を持ちます。メッセージ・テキスト・ソース・ファイルには,セットおよび個別メッセージを処理するための, GENCATで認識されるコマンドを指定することもできます。

メッセージ・テキスト・ソース・ファイルは,いくつ指定しても構いません。 GENCATコマンドは,複数のソース・ファイルを,指定された順に1つずつ処理します。連続する各ソース・ファイルが,カタログを変更します。

catfile という名前のメッセージ・カタログが存在する場合, GENCAT は,旧バージョンの内容を含むファイルを,新バージョンのファイルとして作成し,これを更新します。メッセージ・カタログが存在しない場合,GENCATは, catfile という名前のカタログを作成します。

catfile には,次のコマンドを指定できます。

各初期キーワードまたは番号のあとに,空白がなければなりません。 GENCATユーティリティは,行の先頭にスペース,タブ,またはドル記号 ($) 文字 (スペース,タブ,または改行文字が続く場合) がある場合,その行を無視します。このため,この並びを使用して, catfile 内でコメントを指定できます。空白行も無視されます。 GENCATは,$delset,$quote,または$setコマンドに続く文字を無視するため,これらのコマンドの後にコメントを指定することもできます。

数字ではじまる行は,カタログに取り込まれるメッセージを表します。メッセージID番号とメッセージ・テキストの間に,任意の数の空白を指定できます。ただし,メッセージ・テキストが引用符で区切られていない場合は,スペースまたはタブ文字を1つだけ指定することをおすすめします。メッセージ・テキストが引用符で区切られていない場合,GENCATは,空白もメッセージの一部として処理します。なお,メッセージ・テキストが引用符で区切られている場合には,GENCATは,メッセージIDと先頭の引用符とのあいだのスペースまたはタブを,すべて無視します。

C言語で認識されるようなエスケープ・シーケンスを,テキストの中で使用できます。エスケープ文字のバックスラッシュ(\)を使用すると,メッセージ・テキストに特殊文字を挿入できます。 表 4-1 を参照してください。

表 4-1 特殊文字
エスケープ・
シーケンス
文字
\n 改行
\t 水平タブ
\v 垂直タブ
\b バックスペース
\r キャリッジ・リターン
\f 改ページ
\\ バックスラッシュ文字(\)。メッセージ・テキストを次の行に継続するのに使用する。
\ ddd 8進数 ddd に対応するシングル・バイト文字。 1〜3桁の8進数を指定できる。ただし,8進数に続く文字がやはり有効な8進数の場合は,先頭にゼロを指定する必要がある。たとえば,$ (ドル記号)の8進数は44である。メッセージに$5.00を挿入するには,\445.00ではなく, \0445.00を使用する。そうでない場合には,5が,8進数の一部として解析される。

エラー

GENCATがエラーを報告した場合,コマンドに対して何らかの処理が行われることはなく,既存のカタログはそのまま変更されません。

#1

$set 10 Communication Error Messages 
 

この例は,ソース・ファイルの中で$setコマンドを使用し,メッセージ・グループに対してセット番号を割り当てます。

メッセージ・セット番号は10です。この$setコマンドと次の$setコマンドの間のすべてのメッセージに,メッセージ・セット番号10が割り当てられます (セット番号は昇順に割り当てられなければなりませんが,番号が連続している必要はありません)。

なお, $setコマンドにはコメントを指定できます。

#2

$delset 10 Communication Error Messages 

この例は,$delsetコマンドを使用して,指定されたメッセージ・セット(この場合は10)に属するすべてのメッセージを,カタログから削除します。

$delsetコマンドは,同じソース・ファイル内の$setコマンドに関して,正しいセット番号の順序で指定する必要があります。なお,$delsetコマンドにはコメントを指定できます。

#3

12 "file removed" 

この例は,メッセージ・テキストの入力,およびそれに対するメッセージID番号の割り当て方法を示します。この場合,メッセージID 12が,これに続くテキストに割り当てられます。

メッセージID番号とメッセージ・テキストのあいだには,少なくとも1つのスペースまたはタブ文字が必要ですが,複数のスペースまたはタブを指定しても構いません。複数のスペースまたはタブを指定した場合,これらは,メッセージ・テキストが引用符で囲まれていると無視され,メッセージ・テキストが引用符で囲まれていなければテキストの一部と見なされます。

メッセージ番号は,1つのメッセージ・セットの中で昇順でなければなりませんが,番号が連続している必要はありません。

メッセージ番号の後から行の終端までのすべてのテキストが,メッセージ・テキストとして取り込まれます。行の最終文字としてエスケープ文字のバックスラッシュ(\)を指定すると,メッセージ・テキストは次の行に継続します。次の例を参照してください。


This is the text associated with \
message number 5. 

この例に示す2行は,次の1行のメッセージを定義します。

This is the text associated with message number 5.

#4

$quote "   Use a double quote to delimit message text 
$set 10            Message Facility - Quote command messages 
1 "Use the $quote command to define a character \
\n for delimiting message text" \n 
2 "You can include the \"quote\" character in a message \n \
by placing a \\ (backslash) in front of it" \n 
3 You can include the "quote" character in a message \n \
by having another character as the first nonspace \
\n character after the message ID number \n 
$quote 
4 You can disable the quote mechanism by \n \
using the $quote command without \n a character \
after it \n 
 

この例は,引用文字(引用符)の効果を示します。

$quoteコマンドは,二重引用符(")を引用文字として定義します。引用文字は,メッセージ番号の後に指定されるスペース以外の最初の文字でなければなりません。 2番目の引用文字以降のテキストは,すべて無視されます。

この例は,メッセージ・テキストに引用文字を指定する 2通りの方法についても示しています。

この例は,次のことも示しています。


ICONV COMPILE

変換ソース・ファイルから変換テーブル・ファイルを作成します。変換テーブル・ファイルは,ICONV CONVERTコマンドが,ファイル内の文字を,あるコードセットから別のコードセットに変換するのに使用されます。

形式

ICONV COMPILE sourcefile tablefile


パラメータ

sourcefile

必須。

変換ソース・ファイルの名前。デフォルトのファイル・タイプは .ISRC です。弊社は変換ソース・ファイルのファイル命名規則として,次の規則を使用します。


fromcodeset_tocodeset.isrc 

tablefile

必須。

作成する変換テーブル・ファイルの名前。デフォルトのファイル・タイプは .ICONV です。変換テーブル・ファイルのファイル命名規則は次のとおりです。


fromcodeset_tocodeset.iconv 

公用変換テーブル・ファイルは,論理名SYS$I18N_ICONVで定義されるディレクトリにあります。新しく作成した変換テーブル・ファイルを,システム単位で使用できるようにするには,これを同じディレクトリに格納します。


修飾子

/LISTING[=listfile ]

ICONV COMPILEに対して,ソース・ファイル・リスト,およびコンパイル中に生じたエラー・メッセージを含む,リスト・ファイルの作成を指定します。ファイル名の指定が修飾子で省略された場合,デフォルトのリスト・ファイル名は, sourcefile.LISとなります。

説明

ICONVコマンドは,状態独立の1〜4バイト・コードセットをサポートします。状態依存のコードセットはサポートしません。

注意

このインプリメンテーションにおけるtocodeset エンコードには,インプリメンテーションの制約があります。tocodeset 内の文字は, 4番目のバイトに0XFFを使用してはなりません。

変換ソース・ファイルには,特定の変換についての文字変換規則が含まれます。

コードセット変換ソース・ファイルの形式は,次のように定義されます。


<fromcodeset_mb_cur_max>    value
<fromcodeset_mb_cur_min>    value
<tocodeset_mb_cur_max>      value
<tocodeset_mb_cur_min>      value
<fallback_code>             value
<escape_char>               value
<comment_char>              value
<fromcodeset_range>         value...value;value...value;...;value...value
ICONV_TABLE 
fromvalue             tovalue
fromvalue             tovalue
   .                                 . 
   .                                 . 
   .                                 . 
fromvalue             tovalue
END ICONV_TABLE 

ここで,シンボル<...>およびこれに対応する値は,コードセット定義であり, fromvalue/tovalueのペアは,文字変換規則です。

コードセット宣言

コードセット宣言は,文字変換規則の前に指定しなければなりません。各宣言は,1桁目からはじまる山括弧で囲まれたシンボル, 1つ以上の空白(タブまたはスペース),シンボルに割り当てられる値の順に構成されます。 表 4-2 を参照してください。

表 4-2 コードセット宣言
シンボル
<fromcodeset_mb_cur_max> fromcodeset内の文字の最大バイト数。デフォルトの値は1。
<fromcodeset_mb_cur_min> fromcodeset内の文字の最小バイト数。この値は, fromcodeset_mb_cur_max以下でなければならない。この値が指定されなかった場合,デフォルトの値としてfromcodeset_mb_cur_maxに設定される。
<tocodeset_mb_cur_max> tocodeset内の文字の最大バイト数。デフォルトの値は1。
<tocodeset_mb_cur_min> tocodeset内の文字の最小バイト数。この値は, tocodeset _mb_cur_max以下でなければならない。この値が指定されなかった場合,デフォルトの値としてtocodeset_mb_cur_maxに設定される。
<fallback_code> <fromcodeset_range>に表示されているが, ICONV_TABLEおよびEND ICONV_TABLE間では指定されていない, fromvalueに対する tovalue。次の3種類の値のいずれかを指定する。

  • SAME --- tovaluefromvalueに等しいことを指定する。

  • ERROR --- fromvalueから tovalueへの変換がサポートされないことを指定する。 ICONV CONVERTは警告メッセージを出力し,読み込まれた残りのレコードを無視する。 Compaq Cランタイム・ライブラリ・ルーチン iconvは,呼び出し側に対して"illegal character"エラーを返す。

  • ユーザ定義の tovalue --- fromvalueは,指定されたユーザ定義の tovalueに変換される。

    ユーザ定義の tovalueはマルチバイト文字を表すことができるが, 4番目のバイトの値として,0XFFを使用できないという制約を伴う。 <fallback_code>におけるユーザ定義の tovalueの設定は,文字変換規則値における設定に等しい。 8進,10進,または16進数を使用できる。 <fallback_code>が指定されなかった場合,デフォルトの値はSAMEとなる。

<escape_char> 後に続く文字を特別な方法で解釈することを指定するためのエスケープ文字。デフォルトのエスケープ文字は,バックスラッシュ(\)である。
<comment_char> 行の1桁目に指定された場合,その行を無視することを指定する文字。デフォルトのコメント文字は,番号記号(#)。
<fromokcodeset_range> fromcodesetのエンコード範囲。fromcodesetがマルチバイト・コードセットの場合にこの定義を指定する。 fromcodesetが省略された場合,デフォルトの設定はシングル・バイト・コードセットであり, ICONV COMPILEで作成されるテーブルは,シングル・バイトのfromcodeset変換だけをサポートする。

fromcodesetに対してコードセット・エンコード範囲を指定する場合,すべての文字ゾーンを指定しなければなりません。 <fromcodeset_range> の指定で文字ゾーンが抜けている場合,コードセット変換が正しく行われないことがあります。他のCompaq Cランタイム・ライブラリ(RTL)でサポートされる fromcodesetに対して,コードセット・エンコード範囲を正しく指定することは,きわめて重要です。この指定が正しく行われなければ,iconv と,他のCompaq C RTLでのコードセット・サポートが一致しません。

たとえば,EUCJPに対するfromcodeset範囲は次のように指定されます。


<fromcodeset_range>  \x0...\x7f;\x8e\xa1...\x8e\xfe; 
                     \xa1\xa1...\xfe\xfe;\x8f\xa1\xa1...\x8f\xfe\xfe 

<fromcodeset_range>値の設定は,文字変換規則値の設定と同じです。8進,10進,または16進数を使用できます。

文字変換規則

文字変換規則は,1桁目から文字列ICONV_TABLEが指定されている行と, 1桁目から文字列END ICONV_TABLEが指定されている行のあいだの,すべての行です。

文字変換規則は,1桁目からはじめる必要があります。

空白行,および1桁目にコメント文字が指定されている行は,無視されます。なお,コメントは省略可能です。

文字変換規則は,次の2種類の形式のいずれかで指定します。


fromvalue               tovalue
 
fromvalue...fromvalue       tovalue

fromvaluetovalueの間には, 1つ以上の空白(タブまたはスペース)を指定します。

単一文字変換規則を定義するには,最初の形式を使用します。この例を次に示します。


\d32       \d101 
\d37       \d106 

文字変換規則の範囲を定義するには,2番目の形式を使用します。この形式の場合,最後に指定するfromvalue は,先頭のfromvalue 以上でなければなりません。範囲で定義される連続するfromvalue は,昇順でtovalue に変換されます。

たとえば,次の行について考えてみます。


\d223\d32...\d223\d35       \d129\d254 

この行は,次のように解釈されます。


\d223\d32       \d129\d254 
\d223\d33       \d129\d255 
\d223\d34       \d130\d0 
\d223\d35       \d130\d1 

fromvalueおよびtovalueは,次のように設定されます。

各定数は,シングル・バイト値を表します。 2つ以上の10進,8進,または16進定数を連結することによって,マルチバイト値を表すことができます。

注意

定数を連結してマルチバイト値を構成する場合,その基数(10進,8進,または16進)は同じでなければなりません。変換ソース・ファイルには,Portable Character Set内の文字のみ使用できます。

ICONV CONVERTコマンドの説明も参照してください。


前へ 次へ 目次 索引