tcflush サブルーチン

オンライン編集

目的

指定されたキューからデータを破棄します。

ライブラリー

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

構文

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

説明

tcflushサブルーチンは、FileDescriptorパラメータによって参照されるオブジェクトに書き込まれたデータ、またはFileDescriptorによって参照されるオブジェクトによって受信されたが読み取られなかったデータを、QueueSelectorパラメータの値に応じて破棄する。

パラメーター

項目 説明
FileDescriptor オープン・ファイル記述子を指定します。
QueueSelector 次のいずれかを指定します。
TCIFLUSH
フラッシュ・データが受信されましたが、読み取られませんでした。
TCOFLUSH
書き込まれたが送信されなかったデータをフラッシュします。
TCIOFLUSH
以下の両方をフラッシュします。
  • データは受信されたが、読み取られなかった
  • 書き込まれたが送信されなかったデータ

戻り値

正常終了時には値 0 が返されます。 そうでない場合は-1が返され、エラーを示すerrnoグローバル変数が設定される。

エラー・コード

以下のいずれかが該当する場合、 TCP フラッシュ サブルーチンは失敗します。

項目 説明
EBADF FileDescriptor パラメーターで、有効なファイル・ディスクリプターが指定されていない。
EINVAL QueueSelector パラメーターに適切な値が指定されていません。
EIO 書き込みプロセスのプロセス・グループは孤立しており、書き込みプロセスは SIGTTOU (S) シグナルを無視またはブロックしません。
ENOTTY FileDescriptor パラメーターに関連付けられたファイルは、端末ではありません。

例

出力待ち行列をフラッシュするには、次のように入力します。

rc = tcflush(2, TCOFLUSH);