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

MLDuplicateLink()

MLINK MLDuplicateLink(MLINK parent, const char *name, int *err)
returns a copy of parent and sets the new link object's name to name.

MORE INFORMATION

The newly created link has an exact copy of the incoming and outgoing data streams of the parent link.

MLDuplicateLink() does not copy user data blocks.

Upon successful completion, MLDuplicateLink() returns a new link object and sets err to MLEOK.

In the event of an error, MLDuplicateLink() returns (MLINK)0 and sets err to the appropriate value.

MLDuplicateLink() is declared in the MathLink header file mathlink.h.

EXAMPLES

CLOSE ALL

Basic Examples (1)

#include "mathlink.h"

/* make a copy of a link */

MLINK f(MLINK lp)
{
    MLINK newlink;
    int error;

    newlink = MLDuplicateLink(lp, (const char *)"Duplicate 1", &error);
    if(newlink  (MLINK)0 || error  MLEOK)
        { /* unable to create a copy of the link */ }

    return newlink;
}