ttyname または isatty サブルーチン

オンライン編集

目的

端末の名前を取得するか、または装置が端末であるかどうかを判別します。

ライブラリー

標準 C ライブラリー (libc.a)

構文

#include <unistd.h>
char *ttyname( FileDescriptor)
int FileDescriptor;
int isatty(FileDescriptor)
int FileDescriptor;

説明

注意: マルチスレッド環境では、 TtyName サブルーチンを使用しないでください。

TtyName サブルーチンは、端末のパス名を取得します。

isatty サブルーチンは、 FileDescriptor パラメーターによって指定されたファイル・ディスクリプターが端末に関連付けられているかどうかを判別します。

脂肪 サブルーチンは、非端末装置が通信回線に接続されている可能性があるため、ユーザーが対話に使用できることを必ずしも示すものではありません。

パラメーター

項目 説明
FileDescriptor オープン・ファイル記述子を指定します。

戻り値

ttyname サブルーチンは、 FileDescriptor パラメーターで指定されたファイル・ディスクリプターに関連した端末装置のヌル終了パス名を含むストリングへのポインターを戻します。 ファイル記述子が /dev ディレクトリー内の端末装置を記述していない場合は、NULL ポインターが戻され、 errno グローバル変数がエラーを示すように設定されます。

TtyName サブルーチンの戻り値は、呼び出しごとに内容が上書きされる静的データを指す場合があります。

指定されたファイル・ディスクリプターが端末に関連付けられている場合、 脂肪 サブルーチンは値 1 を戻します。 ファイル記述子が端末に関連付けられていない場合は、値 0 が戻され、エラーを示すために エラー番号 グローバル変数が設定されます。

エラー・コード

以下のいずれかに該当する場合、 TtyName および 脂肪 サブルーチンは失敗します。

項目 説明
EBADF FileDescriptor パラメーターで、有効なファイル・ディスクリプターが指定されていない。
ENOTTY FileDescriptor パラメーターが端末装置を指定していません。

ファイル

項目 説明
/dev/* 端末装置特殊ファイル。