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].
  • WSTP 的标头文件 wstp.h 已对 WSReadyParallel() 作出声明.

范例

基本范例  (1)

#include "wstp.h"

/* read data from either of two links */

void f(WSENV env, WSLINK lp1, WSLINK lp2)
{
    mltimeval 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 */
        }
}