DOCUMENTATION CENTER SEARCH
Mathematica > Systems Interfaces & Deployment > C/C++ Language Interface > MathLink C Language Functions >
Mathematica > Systems Interfaces & Deployment > MathLink API > MathLink C Language Functions >
MathLink C Function

MLGetType()

int MLGetType(MLINK link)
gets the type of the current object on the MathLink connection specified by link.
  • Unlike MLGetNext(), MLGetType() does not advance to the next object on link, so it can be safely called more than once for the same object.
  • The following types can be returned:
MLTKERRerror
MLTKINTinteger
MLTKFUNCcomposite function
MLTKREALapproximate real number
MLTKSTRcharacter string
MLTKSYMsymbol
MLTKOLDINTinteger from older versions of the MathLink library
MLTKOLDREALapproximate real number from older versions of the MathLink library
MLTKOLDSTRcharacter string from older versions of the MathLink library
MLTKOLDSYMsymbol from older versions of the MathLink library
  • MLTKINT and MLTKREAL do not necessarily signify numbers that can be stored in C int and double variables.
  • MLGetType() is declared in the MathLink header file mathlink.h.
EXAMPLESCLOSE ALL
Basic Examples   (1)
#include "mathlink.h"

/* read the type of the expression from a link */

void f(MLINK lp)
{
    switch(MLGetType(lp))
    {
        case MLTKINT:
            /* read the integer */
        case MLTKREAL:
            /* read the floating point number */
        case MLTKSTR:
            /* read the string. */

        /* ... */
    }
}
© 2008 Wolfram Research, Inc.
Ask a question about this page  |  Suggest an improvement  |  Leave a message for the team