名称

XStoreBytes, XStoreBuffer, XFetchBytes, XFetchBuffer, XRotateBuffers − カットおよびペーストバッファを操作する

形式

XStoreBytes(display, bytes, nbytes)
      Display ∗display;
      char ∗bytes;
      int nbytes;
XStoreBuffer(display, bytes, nbytes, buffer)
      Display ∗display;
      char ∗bytes;
      int nbytes;
      int buffer; char ∗XFetchBytes(display, nbytes_return)
      Display ∗display;
      int ∗nbytes_return; char ∗XFetchBuffer(display, nbytes_return, buffer)
      Display ∗display;
      int ∗nbytes_return;
      int buffer; XRotateBuffers(display, rotate)
      Display ∗display;
      int rotate;

引数

bufferバイトをストアしたいバッファまたは、ストアされているデータを返してほし いバッファを指定します。

bytesバイト列を指定します。それは必ずしも ASCII 列またはナルで終わるバイト列 である必要はありません。

displayX サーバへのコネクションを指定します。

nbytesストアするバイト数を指定します。

nbytes_return
バッファ内のバイト数を返します。

rotateカットバッファをどの位ローテートするのか指定します。

解説

データはナル文字を最後に含むこともありますが、 ナルで終了する必要はありません。 カットバッファの内容は、後で、 XFetchBytes を呼び出すクライアントにより検索することができます。 XStoreBytes は、 BadAlloc エラーを生じることがあります。 不法なバッファが指定された場合は、呼び出しは、何も影響を与えません。 データはナル文字を最後に含むこともありますが、 ナルで終了する必要はありません。 XStoreBuffer は、 BadAlloc エラーを生じることがあります。 XFetchBytes 関数は、 バッファがデータを含んでいる場合は、nbytes_return 引数中の バイト数を返します。 そうでない場合は、 XFetchBytes 関数は NULL を返し、nbytes をゼロに設定します。 記憶領域の適量が割り当てられ、そのポインタが返されます。 クライアントは、この記憶領域に用がなくなったら、 XFree によって解放しなければなりません。 XFetchBuffer 関数は、バッファ内に何もデータがない場合、または、 不法なバッファが指定された場合は、nbytes_return 引数へ ゼロを返します。 XFetchBuffer は、 BadValue エラーを生じることがあります。 XRotateBuffers 関数は、 例えばバッファ 0 がバッファ n に、 バッファ 1 が n + 1 mod 8 になるように、カットバッファをローテートします。 このカットバッファのナンバリングは、ディスプレイに対しグローバルです。 なお、 XRotateBuffers は、8 つのバッファのどれかが作成されていない場合は、 BadMatch を生じることに注意して下さい。 XRotateBuffers は、 BadMatch エラーを生じることがあります。

診断

BadAlloc サーバが要求されたリソースまたはサーバメモリの割り当てに失敗した。

BadAtom Atom 引数の値が定義された Atom を指さない。

BadMatch ある引数またはひと組の引数の型および範囲は正しいが、 リクエストにより要求されたその他の何かが一致しない。

BadValue ある数値が許容範囲を超えた。 引数の値の範囲が明示されない限り、 引数の型によって決まる最大の範囲まで指定可能です。 選択形式の引数も、このエラーを生じることがあります。

関連事項

XFree(3X11)
Xlib − C Language X Interface

NEWS-OSRelease 4.2.1R