fldata() - ファイル情報の検索

標準

形式

#include <stdio.h>

int fldata(FILE *file, char *filename, fldata_t *info);

#define _OPEN_SYS_UNLOCKED_EXT 1
#include <stdio.h>

int fldata_unlocked(FILE *file, char *filename, fldata_t *info);

機能説明

file によって指定されるオープン・ストリームについての 情報を得ます。ファイル名を filename に、その他の情報を構造体 info に戻します。filename に戻されるファイル名は、fopen() また は freopen() で指定された名前です。ファイルが ddname (例えば、fopen("DD:A","w")) でオープンされると、filename フィールドには、ファイルをオープンするのに使用される ddname が、dd: という接頭部付きで入ります。ファイルが DASD データ・セットまたはメモリー・ファイルである場合は、フ ィールド __dsname には dsname が入ります。ファイルが HFS ファイルの場合は、フィールド __dsname には、パス名が入ります。その他のファイルでは、NULL になります。

障害がある場合は、情報構造体の内容は不明確です。

ユーザーのネーム・スペースが侵害されるのを回避するため、この非標準関数には 2 つの名前があります。1 つの名前の接頭部には 2 つの下線文字が付き、もう 1 つの名前の接頭部には付きません。接頭部下線文字が付いていない名前は、LANGLVL(EXTENDED) を使用する場合にのみ表示されます。

この関数を使用するには、その外部エントリー・ポイント名 (2 つの下線文字で始まる名前) を使用して呼び出すか、LANGLVL(EXTENDED) を使用してコンパイルする必要があります。LANGLVL(EXTENDED) を使用すると、ヘッダー内の関連情報も表示されます。

filename に関する考慮事項について詳しくは、「z/OS XL C/C++ プログラミング・ガイド」の『ファイルのオープン』の該当するトピックを参照してください。

fldata で標準ストリームがはじめて参照 される場合、fldata() 関数を呼び出すと、このストリームがオープンされます。

表 1 を参照してください。

この後の表 "fldata_t データ構造に戻されるエレメント"では、fldata_t データ構造のフィールドについて説明しています。詳細は、「z/OS XL C/C++ プログラミング・ガイド」を参照してください。

fldata_unlocked() は、スレッド・セーフでないことを除いて、機能的に fldata() と 等価です。この関数をマルチスレッドのアプリケーション内で安全に使用できるのは、 flockfile() 関数または ftrylockfile() 関数のどちらかへの呼び出しが成功した後のように、 呼び出しスレッドが (FILE*) オブジェクトを所有している間に、この関数を呼び出す場合だけです。

POSIX C の特殊な動作: z/OS®UNIX サービスの下では、fldata() を呼び出すアプリケーションに対する exec が以前にあった場合、その exec の実行時に標準ストリームはオープンされています。 従って、fldata() はそれらをもう一度オープンしようとはしません。

戻り値

正常に実行された場合、fldata() は 0 を戻します。

正常に実行されなかった場合は、fldata() はゼロ以外を戻します。

例

#include <stdio.h>

int main(void)
{
    FILE *stream;
    char filename[100];
    fldata_t fileinfo;
    int rc;

    stream = fopen("myfile.dat","rb+");
⋮
    rc = fldata(stream, filename, &fileinfo);
    if (rc != 0)
       printf("fldata failed¥n");
    else
       printf("filename is %s¥n",filename);
}

関連情報

• stdio.h
• fopen() - ファイルのオープン
• freopen() - オープン・ファイルの宛先変更