MLReadyParallel()

int MLReadyParallel(MLENV env, MLINK *links, int n, mltimeval waittime)
takes a list of link objects of length n and waits a timeout period specified by waittime for one of those links to have data ready to read.

DetailsDetails

  • MLReadyParallel() returns the index into the list of link objects of the link that has data to read. The links are indexed from to .
  • MLReadyParallel() returns MLREADYPARALLELTIMEDOUT if no link has data to read after the timeout period expires.
  • MLReadyParallel() returns MLREADYPARALLELERROR in the event of an error.
  • To wait for an indefinite period until a link is ready, set waittime to MLINFINITEWAIT.
  • MLReadyParallel() cannot be used as a fine-grained wait mechanism.
  • MLReadyParallel() is analogous to the kernel function LinkReadyQ[{}, waittime].
  • MLReadyParallel() is declared in the MathLink header file mathlink.h.

ExamplesExamplesopen allclose all

Basic Examples (1)Basic Examples (1)

#include "mathlink.h"

/* read data from either of two links */

void f(MLENV env, MLINK lp1, MLINK lp2)
{
    mltimeval timeout;
    MLINK links[2];
    int result;

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

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

    result = MLReadyParallel(env, (MLINK *)links, 2, timeout);
    if(result == MLREADYPARALLELERROR)
        { /* unable to check links for data */ }
    else if(result != MLREADYPARALLELTIMEDOUT)
        {
            /* read the link that has data ready */
            if(result == 0)
                /* read lp1 */
            else
                /* read lp2 */
        }
}
New to Mathematica? Find your learning path »
Have a question? Ask support »