Sous-routine ttyname ou isatty
Objectif
Extrait le nom d'un terminal ou détermine si l'unité est un terminal.
Bibliothèque
Bibliothèque C standard (libc.a)
Syntaxe
#include <unistd.h> int FileDescriptor;
int isatty(FileDescriptor)
int FileDescriptor;Descriptif
Le sous-programme Nom_ttyt obtient le nom de chemin d'un terminal.
La sous-routine isatty détermine si le descripteur de fichier spécifié par le paramètre FileDescriptor est associé à un terminal.
Le sous-programme Isatty n'indique pas nécessairement qu'une personne est disponible pour l'interaction, car les périphériques non terminaux peuvent être connectés à la ligne de communication.
Paramètres
| Article | Descriptif |
|---|---|
| FileDescriptor | Indique un descripteur de fichier ouvert. |
Valeurs renvoyées
La sous-routine ttyname renvoie un pointeur vers une chaîne contenant le nom de chemin à terminaison nulle de l'unité de terminal associée au descripteur de fichier spécifié par le paramètre FileDescriptor . Un pointeur null est renvoyé et la variable globale errno est définie pour indiquer l'erreur si le descripteur de fichier ne décrit pas une unité de terminal dans le répertoire /dev .
La valeur de retour de la sous-routine Nom_ttyt peut pointer vers des données statiques dont le contenu est écrasé par chaque appel.
Si le descripteur de fichier spécifié est associé à un terminal, la sous-routine Isatty renvoie une valeur de 1. Si le descripteur de fichier n'est pas associé à un terminal, la valeur 0 est renvoyée et la variable globale Errno est définie pour indiquer l'erreur.
Codes d'erreur
Les sous-routines Nom_ttyt et Isatty ne sont pas réussies si l'une des opérations suivantes est vraie:
| Article | Descriptif |
|---|---|
| EBADF | Le paramètre FileDescriptor ne spécifie pas de descripteur de fichier valide. |
| ENOTTY | Le paramètre FileDescriptor ne spécifie pas d'unité de terminal. |
Fichiers
| Article | Descriptif |
|---|---|
| /dev/* | Fichiers spéciaux de l'unité de terminal. |