Sous-routine tcflush

Objectif

Décarte les données de la file d'attente spécifiée.

Bibliothèque

Bibliothèque C standard (libc.a)

Syntaxe

#include <termios.h>
int tcflush( FileDescriptor QueueSelector)
int FileDescriptor;
int QueueSelector;

Descriptif

Le sous-programme tcflush rejette toutes les données écrites dans l'objet auquel se réfère le paramètre FileDescriptor, ou les données reçues mais non lues par l'objet auquel se réfère FileDescriptor, en fonction de la valeur du paramètre QueueSelector.

Paramètres

Article Descriptif
FileDescriptor Indique un descripteur de fichier ouvert.
QueueSelector Indique l'une des informations suivantes:
TCIFLUSH
Données de vidage reçues mais non lues.
TCOFLUSH
Données de vidage écrites mais non transmises.
TCIOFLUSH
Vider les deux éléments suivants:
  • Données reçues mais non lues
  • Données écrites mais non transmises

Valeurs renvoyées

Une fois l'exécution terminée, la valeur 0 est renvoyée. Dans le cas contraire, la valeur -1 est renvoyée et la variable globale errno est définie pour indiquer l'erreur.

Codes d'erreur

La sous-routine Tcflush échoue 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.
EINVAL Le paramètre QueueSelector ne spécifie pas de valeur correcte.
EIO Le groupe de processus du processus d'écriture est orphelin et le processus d'écriture n'ignore pas ou ne bloque pas le signal SIGTTOU .
ENOTTY Le fichier associé au paramètre FileDescriptor n'est pas un terminal.

Exemple

Pour vider la file d'attente en sortie, entrez:

rc = tcflush(2, TCOFLUSH);