WSReadyParallel （C 関数）

int WSReadyParallel(WSENV env,WSLINK *links,int n,wstimeval waittime)

長さn のリンクオブジェクトのリストを取り，そのリンクの一つに読取り可能なデータがあるようになるのをwaittime で指定されたタイムアウト時間待つ．

詳細

  • WSReadyParallel()は，読み取るデータを持つリンクのリンクオブジェクトリストに，インデックスを返す． リストは，0から(n-1)までインデックスを付ける．
  • WSReadyParallel()は，タイムアウト時間が終っても読み取るデータを持つリンクがない場合，WSREADYPARALLELTIMEDOUTを返す．
  • WSReadyParallel()はエラーがあると，WSREADYPARALLELERRORを返す．
  • リンクの準備ができるまで無期限に待つ場合には，waittime をWSINFINITEWAITに設定するとよい．
  • WSReadyParallel()を非常に細かい待機メカニズムとして使うことはできない．
  • WSReadyParallel()は，カーネル関数LinkReadyQ[{},waittime]に似ている．
  • WSReadyParallel()は，WSTPヘッダファイルwstp.hの中で宣言される．

例題

例  (1)

#include "wstp.h"

/* read data from either of two links */

void f(WSENV env, WSLINK lp1, WSLINK lp2)
{
    wstimeval timeout;
    WSLINK links[2];
    int result;

    timeout.tv_sec = 5;
    timeout.tv_usec = 0;

    links[0] = lp1;
    links[1] = lp2;

    result = WSReadyParallel(env, (WSLINK *)links, 2, timeout);
    if(result == WSREADYPARALLELERROR)
        { /* unable to check links for data */ }
    else if(result != WSREADYPARALLELTIMEDOUT)
        {
            /* read the link that has data ready */
            if(result == 0)
                /* read lp1 */
            else
                /* read lp2 */
        }
}