fopen() — ファイルのオープン

F

固定長、非ブロック化レコード

FB

固定長、ブロック化レコード

V

可変長、非ブロック化レコード

VB

可変長、ブロック化レコード

VBS

テープ・ファイル用の可変長で、ブロック化したスパン・レコード

VS

テープ・ファイル用の可変長で、非ブロック化したスパン・レコード

D

テープ・ファイル用 ASCII D 形式の、可変長で、非ブロック化した非スパン・レコード

DB

テープ・ファイル用 ASCII D 形式の、可変長で、ブロック化した非スパン・レコード

U

テープ・ファイルの不定形式

FA

固定長で、出力ファイル用に先頭文字書式制御データを使用

N このパラメーターは、このファイルがコミットメント制御下でオープンされないことを識別します。 これはデフォルトです。

Y このパラメーターは、このファイルがコミットメント制御下でオープンされることを識別します。

コンパイル・コマンドに LOCALETYPE(*LOCALEUTF) が指定された場合は、デフォルト値は LC_CTYPE CCSID の値です。これは、現行ロケール設定によって決まります。 ロケール設定について詳しくは、setlocale() — ロケールの設定を参照してください。コンパイル・コマンドに LOCALETYPE(*LOCALEUTF) が指定されていない場合、デフォルト値はジョブの CCSID の値です。ファイルの CCSID の値について詳しくは、ファイルの CCSIDを参照してください。

N このパラメーターは、ファイルが作成された方法で、このファイルが処理されていることを識別します。 これはデフォルトです。

Y このパラメーターは、このファイルが到着順で処理されることを識別します。

N この値は、ディスプレイ、ICF、またはプリンター・ファイルの標識がファイル・バッファーに格納されていることを識別します。 これはデフォルトです。

Y このパラメーターは、ディスプレイ、ICF、またはプリンター・ファイルの標識が、ファイル・バッファーではなく、別の標識領域に格納されていることを識別します。 ファイル・バッファーは、書き込みと読み込みのときにシステムがユーザー・プログラムとオペレーション・システム間でデータを転送するために使用する領域です。 ICF ファイルを処理する場合には標識を別の標識領域に格納する必要があります。

memory このパラメーターは、C プログラムからのみ使用できるメモリー・ファイルとして、このファイルを識別します。 これはデフォルトです。

record このパラメーターは、順次レコード入出力用にファイルがオープンされることを指定します。ファイルはバイナリー・ファイルとしてオープンされる必要があります。そうでない場合、fopen() 関数は失敗します。読み取り操作と書き込み操作は fread() 関数と fwrite() 関数によって行います。

record ファイルは順次レコード入出力用にオープンされます。(ファイルはバイナリー・ストリームとしてオープンされる必要があります。)

ccsid キーワードを指定する場合は、o_ccsid キーワードやコード・ページ・キーワードを指定できません。

変換されたデータが拡大したり縮小する可能性があるため、データ・サイズや現行のファイル・オフセットを推測することは危険です。 例えば、100 バイトの物理サイズを持つファイルで、アプリケーションがファイルから 100 バイトを読み取った後のファイル・オフセットは 50 しかない場合があります。 含まれている CCSID によっては、ファイル全体を読み取るために、アプリケーションが 200 バイト以上を読み取る必要がある場合があります。このため、ftell()、fseek()、fgetpos()、fsetpos() などのファイル位置決め関数が機能しないことがあります。 これらの関数はエラー ENOTSUP が発生して失敗します。関数の読み取りは、デフォルトのように、バッファリングがオンの場合にも機能しません。 バッファリングをオフにするには、_IONBF キーワードを指定して setvbuf 関数を使用します。

コンパイル・コマンドに LOCALETYPE(*LOCALEUTF) が指定された場合は、デフォルト値は LC_CTYPE CCSID の値です。これは、現行ロケール設定によって決まります。 ロケール設定について詳しくは、setlocale() — ロケールの設定を参照してください。コンパイル・コマンドに LOCALETYPE(*LOCALEUTF) が指定されていない場合、デフォルト値はジョブの CCSID の値です。ファイルの CCSID の値について詳しくは、ファイルの CCSIDを参照してください。

このパラメーターは、指定された値がコード・ページに変換されない点を除き、ccsid パラメーターと類似しています。 また、混合データもサポートされています。ファイルが作成されると、指定された CCSID でタグ付けされます。ファイルがすでに存在している場合、データは読み取り操作時に、ファイルの CCSID から指定された CCSID に変換されます。 書き込み操作では、データは指定された CCSID にあると仮定され、ファイルの CCSID に変換されます。

変換されたデータが拡大したり縮小する可能性があるため、データ・サイズや現行のファイル・オフセットを推測することは危険です。 例えば、100 バイトの物理サイズを持つファイルで、アプリケーションがファイルから 100 バイトを読み取った後のファイル・オフセットは 50 しかない場合があります。 含まれている CCSID によっては、ファイル全体を読み取るために、アプリケーションが 200 バイト以上を読み取る必要がある場合があります。このため、ftell()、fseek()、fgetpos()、fsetpos() などのファイル位置決め関数が機能しません。 これらの関数は、ENOTSUP を発生して失敗します。関数の読み取りは、デフォルトのように、バッファリングがオンの場合にも機能しません。 バッファリングをオフにするには、_IONBF キーワードを指定して setvbuf 関数を使用します。

o_ccsid

/* Create a file that is tagged with CCSID 37 */
if ((fp = fopen("/MYFILE" , "w, o_ccsid=37")) == NULL) {
   printf("Failed to open file with o_ccsid=37¥n");
}

fclose(fp);

/* Now reopen the file with CCSID 13488, because your application
 wants to deal with the data in UNICODE */

if ((fp = fopen("/MYFILE" , "r+, o_ccsid=13488")) == NULL) {
   printf("Failed to open file with o_ccsid=13488¥n");
}
/* Turn buffering off because read functions do not work when
buffering is on */

if (setbuf(fp, NULL, _IONBF, 0) != 0){
    printf("Unable to turn buffering off¥n");
}
/* Because you opened with o_ccsid = 13488, you must provide
all input data as unicode.
If this program is compiled with LOCALETYPE(*LOCALEUCS2),
L constrants will be unicode. */

funcreturn = fputws(L"ABC", fp); /* Write a unicode ABC to the file. */

if (funcreturn < 0) {
   printf("Error with 'fputws' on line %d¥n", __LINE__);
}
/* Because the file was tagged with CCSID 37, the unicode ABC was
converted to EBCDIC ABC when it was written to the file. */

コード・ページ・キーワードを指定する場合は、ccsid キーワードや o_ccsid キーワードは指定できません。

オープンするファイルが存在しておらず、オープン・モードでファイルを作成するように指定した場合は、ファイルが作成されて計算されたコード・ページでタグ付けされます。 ファイルがすでに存在している場合は、ファイルから読み取られるデータがファイル・コード・ページから計算されたコード・ページに、読み取り操作中に変換されます。ファイルに書き込まれるデータは、計算されたコード・ページにあり、書き込み操作中にファイルのコード・ページに変換されると仮定されます。

Y 使用される行の終了文字は、復帰改行文字 [CR] と改行文字 [NL] の組み合わせです。データが読み取られるときに、復帰改行文字 [CR] が string 関数のためにストリップされます。データがファイルに書き込まれるときには、復帰改行文字 [CR] がそれぞれの改行文字 [NL] の前に追加されます。行の終了文字処理は、ファイルがテキスト・モードでオープンされている場合にのみ発生します。 これはデフォルトです。

N 使用される行の終了文字は、改行文字 [NL] のみです。