OpenVMS マニュアル

第 2 章
入出力について

HP C Run-Time Library (RTL) には，3 種類の入出力 (I/O) があります。それは UNIX I/O，標準 I/O，端末 I/Oです。 表 2-1 は， HP C RTL のすべての I/O 関数とマクロを示しています。各関数とマクロの詳細については，『HP C ランタイム・ライブラリ・リファレンス・マニュアル (下巻)』「リファレンス・セクション」を参照してください。

2.1 RTL ルーチンからの RMS の使用

HP C RTL の I/O 関数とマクロを使用してファイルを作成する場合，次の属性も含めて，多くの RMS ファイル属性の値を指定できます。

• 割り当てサイズ

• ブロック・サイズ

• デフォルトのファイル拡張

• デフォルトのファイル名

• ファイル・アクセス・コンテキスト・オプション

• ファイル処理オプション

• ファイル共用オプション

• マルチブロック・カウント

• マルチバッファ・カウント

• 最大レコード・サイズ

• レコード属性

• レコード・フォーマット

• レコード処理オプション

これらの値の詳細については，「リファレンス・セクション」の creat関数の説明を参照してください。

これらの値は， open， fopen， freopenなどの関数でも設定できます。

RMS の詳細については，『HP C User's Guide for OpenVMS Systems』を参照してください。

2.2 UNIX I/O と標準 I/O

UNIX I/O 関数は UNIX システム・サービスであり，現在は ISO POSIX-1 (ISO Portable Operating System Interface) によって標準化されています。

UNIX I/O 関数では，ファイル記述子を使用してファイルにアクセスします。 ファイル記述子とは，ファイルを識別する整数です。ファイル記述子は次のように宣言されます。ここで， file_desc はファイル記述子の名前です。

int  file_desc; 

creatなどの UNIX I/O 関数は，ファイル記述子をファイルに関連付けます。次の例について考えてみましょう。

file_desc1 = creat("INFILE.DAT", 0, "rat=cr", "rfm=var"); 

この文は，ファイル・アクセス・モード 0，キャリッジ・リターン制御，可変長レコードで INFILE.DAT というファイルを作成し，変数 file_desc1をファイルに関連付けます。読み込みや書き込みなどの操作のためにファイルにアクセスするときは，ファイル記述子を使用してファイルを参照します。次の例を参照してください。

write(file_desc1, buffer, sizeof(buffer)); 

この文はバッファの内容を INFILE.DAT に書き込みます。

標準 I/O 関数やマクロの代わりに， UNIX I/O 関数やマクロを使用しなければならない状況があります。この 2 種類の I/O の詳細についてと，各 I/O で RMS ファイル・フォーマットがどのように操作されるかについては， 第 1 章 を参照してください。

標準 I/O 関数は ANSI C 標準で指定されています。

標準 I/O 関数では，UNIX I/O の機能にバッファリング機能が追加され，ファイルにアクセスするためにファイル・ポインタが使用されます。 ファイル・ポインタとは， FILE *型のオブジェクトです。これは，次に示すように， <stdio.h>ヘッダ・ファイルに定義されている typedefです。

typedef  struct  _iobuf  *FILE; 

_iobuf識別子も <stdio.h>に定義されています。

ファイル・ポインタを宣言するには，次のように指定します。

FILE  *file_ptr; 

既存のファイルの作成やオープンには，標準 I/O の fopen関数を使用します。次の例を参照してください。

#include <stdio.h> 
 
main() 
{ 
   FILE  *outfile; 
   outfile  =  fopen("DISKFILE.DAT", "w+"); 
      . 
      . 
      . 
} 

この例では，ファイル DISKFILE.DAT が書き込み更新アクセスのためにオープンされます。

HP C RTL では，ファイル記述子とファイル・ポインタの間の変換のために，次の関数が用意されています。

• fileno---指定されたファイル・ポインタに関連付けられているファイル記述子を返します。

• fdopen--- open， creat， dup， dup2， pipe関数から返されたファイル記述子にファイル・ポインタを関連付けます。

2.3 ワイド文字 I/O 関数とバイト I/O 関数

ワイド文字 I/O 関数は，大部分のバイト I/O 関数と同様の動作を実行します。ただし，基本単位としてワイド文字を取り扱う点がバイト I/O 関数と異なります。

しかし，外部表現 (ファイル内の表現) はワイド文字ではなく，マルチバイト文字シーケンスです。ワイド文字で書式設定された入出力関数の場合，次のことに注意してください。

• ワイド文字で書式設定された入力関数 ( たとえば fwscanfなど ) は，指定されたディレクティブとは無関係に，常にファイルからマルチバイト文字シーケンスを読み込み，このシーケンスをワイド文字シーケンスに変換してから，その後の処理を実行します。

• ワイド文字で書式設定された出力関数 ( たとえば fwprintfなど ) は，最初にワイド文字型の引数をマルチバイト文字シーケンスに変換した後，オペレーティング・システムの出力プリミティブを呼び出すことにより，ワイド文字を出力ファイルに書き込みます。

バイト I/O 関数は状態依存エンコーディングを取り扱うことができません。ワイド文字 I/O 関数はこのような操作が可能です。ワイド文字 I/O 関数は，各ワイド文字ストリームを mbstate_t型の変換状態オブジェクトに関連付けることにより，この操作を実行します。

ワイド文字 I/O 関数は次のとおりです。

fgetwc        fputwc        fwscanf       fwprintf       ungetwc 
fgetws        fputws        wscanf        wprintf 
getwc         putwc                       vfwprintf 
getwchar      putwchar                    vwprintf 

バイト I/O 関数は次のとおりです。

fgetc         fputc         fscanf        fprintf         ungetc 
fgets         fputs         scanf         printf          fread 
getc          putc                        vfprinf         fwrite 
gets          puts                        vprintf 
getchar       putchar 

ワイド文字入力関数は， fgetwc関数を連続して呼び出すことによって書き込まれる場合，ストリームからマルチバイト文字を読み込み，これらの文字をワイド文字に変換します。各変換は，ストリーム独自の mbstate_tオブジェクトによって記述される変換状態を指定して mbrtowc関数を呼び出したかのように実行されます。

ワイド文字出力関数は， fputwc関数を連続して呼び出すことにより書き込んだかのように，ワイド文字をマルチバイト文字に変換し，これらの文字をストリームに書き込みます。各変換は，I/O ストリームの独自の mbstate_tオブジェクトによって記述される変換状態を指定して wcrtomb関数を呼び出したかのように実行されます。

ワイド文字 I/O 関数で不正なマルチバイト文字が検出されると， errnoが EILSEQ に設定されます。