Mathematica 9 is now available
SEARCH MATHEMATICA 8 DOCUMENTATION
THIS IS DOCUMENTATION FOR AN OBSOLETE PRODUCT.
SEE THE DOCUMENTATION CENTER FOR THE LATEST INFORMATION.
Mathematica > MathLink C Language Functions >
MathLink C Function

MLGetRealList()

int MLGetRealList(MLINK link, double **a, long *n)
gets a list of floating-point numbers from the MathLink connection specified by link, storing the numbers in the array a and the length of the list in n.
  • MLGetRealList() allocates memory for the array of numbers. You must call MLDisownRealList() to disown this memory. If MLGetRealList() fails and the function's return value indicates an error, do not call MLDisownRealList() on the contents of a.
  • MLGetRealList() returns immutable data.
  • MLGetRealList() returns 0 in the event of an error, and a nonzero value if the function succeeds.
  • Use MLError() to retrieve the error code if MLGetRealList() fails.
EXAMPLESCLOSE ALL
Basic Examples   (1)
#include "mathlink.h"

/* read a list of double-precision floating-point numbers from a link */

void f(MLINK lp)
{
    double *list;
    long length;

    if(! MLGetReal64List(lp, &list, &length))
        {
            /* unable to read the list of numbers from lp */
            return;
        }

    /* ... */

    MLDisownRealList(lp, list, length);
}
© 2013 Wolfram Research, Inc. Japanese
Ask a question about this page  |  Suggest an improvement  |  Leave a message for the team