端末のデバイス名を調べる

# posix_ttyname

(PHP 4, PHP 5, PHP 7, PHP 8)

posix_ttyname — 端末のデバイス名を調べる

### 説明

function posix_ttyname(resource|int `$file_descriptor`): string|false

ファイル記述子 `file_descriptor` 上でオープンしている現在の端末デバイスへの絶対パスを文字列で返します。

### パラメータ

`file_descriptor`
  ファイル記述子。ファイルリソースか、あるいは int で指定します。 int を指定した場合は、システムコールにそのまま渡せるファイル記述子だとみなします。

### 戻り値

成功した場合に `file_descriptor` の絶対パスを表す文字列、 失敗した場合に `false` を返します。

### エラー / 例外

`file_descriptor` が無効な整数値の場合、 `E_WARNING` が発生します。

### 変更履歴

バージョン | 説明
--- | ---
8.5.0 | 無効な `file_descriptor` に遭遇した場合に、 last_error に `EBADF` を設定するようになりました。
8.3.0 | 通常の PHP の型変換のセマンティクスに従い、 整数を変換した場合に、型のエラーに関する `E_WARNING` が発生するようになりました。
8.3.0 | `file_descriptor` が無効な整数値の場合に、 `E_WARNING` が発生するようになりました。

### 参考

- posix_isatty() - ファイルディスクリプタが対話型端末であるかどうかを判定する
- stream_isatty() - ストリームがターミナル型のデバイスかを調べる

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open