|
≫ |
|
|
|
HP OpenVMS HP C ランタイム・ライブラリ・リファレンス・マニュアル (下巻)
ファイル記述子に関連付けられているファイル指定を返します。
形式
#include <unixio.h>
char *getname (int file_desc, char *buffer, ...);
関数バリアント
getname関数には,
_getname32および
_getname64という名前のバリアントがあり,それぞれ 32 ビット・ポインタ・サイズおよび 64 ビット・ポインタ・サイズで使用されます。ポインタ・サイズ固有の関数の使い方の詳細については,『HP C ランタイム・ライブラリ・リファレンス・マニュアル(上巻)』第 1.9 節を参照してください。
引数
file_descファイル記述子。
bufferファイル指定を格納できるだけの十分な大きさの文字列を指すポインタ。
...省略可能な引数であり,1 または 0 に設定できます。1 を指定した場合は,
getname関数は OpenVMS 形式でファイル指定を返します。 0 を指定した場合は,UNIX 形式でファイル指定を返します。この引数を省略すると,現在のコマンド言語インタプリタ (CLI) に従ってファイル名を返します。 UNIX 形式のファイル指定の詳細については,『HP C ランタイム・ライブラリ・リファレンス・マニュアル(上巻)』第 1.3.3 項を参照してください。
説明
getname関数は, buffer によって示される領域にファイル指定を格納し,そのアドレスを返します。buffer によって示される領域は,完全に修飾したファイル指定 ( 最大長は 256 文字 ) を格納できるだけの十分な大きさの配列でなければなりません。
戻り値
x
|
buffer 引数に渡されたアドレス。
|
0
|
エラーを示します。
|
|