posix_ttyname

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

posix_ttyname — Ermittelt den Namen des Terminal-Devices

Beschreibung

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

Gibt den absoluten Pfad zum aktuellen Terminal-Device, das mit dem Dateideskriptor file_descriptor geöffnet ist, als String zurück.

Parameter-Liste

file_descriptor: Der Datei-Deskriptor, welcher entweder eine Datei-Ressource oder ein Wert vom Typ int sein sollte. Ist dies ein int, dann wird davon ausgegangen, dass es sich um einen Dateideskriptor handelt, welcher direkt an den zugrundeliegenden Systemaufruf übergeben werden kann.

Rückgabewerte

Gibt bei Erfolg den absoluten Pfad des Dateideskriptors file_descriptor als String zurück. Falls ein Fehler auftrat, wird false zurückgegeben.

Fehler/Exceptions

Ungültige ganzzahlige file_descriptor-Werte führen zu einem E_WARNING.

Changelog

Version	Beschreibung
8.3.0	Wenn ein Integer zwangsweise umgewandelt wird (coercive typing), wird nun ein Typfehler der Stufe `E_WARNING` ausgelöst, der der üblichen PHP-Semantik für Typzwang entspricht.
8.3.0	Ungültige ganzzahlige `file_descriptor`-Werte führen nun zu einem `E_WARNING`.

Siehe auch

posix_isatty() - Ermittelt, ob ein Dateideskriptor ein interaktives Terminal ist
stream_isatty() - Check if a stream is a TTY

＋add a note

User Contributed Notes 1 note

down

casper at bcx dot nl ¶

17 years ago

<?php
    var_dump( posix_ttyname(STDOUT) );
?>

returns:
string(10) "/dev/pts/0"

When using pseudo terminal 1 (ie ssh)

＋add a note