MathLinkFactoryCreateKernelLink(String) Method

Creates a link to a Wolfram Language kernel based on MathLink/WSTP parameters supplied as an argv-type array of strings.

Definition

Namespace: Wolfram.NETLink
Assembly: Wolfram.NETLink (in Wolfram.NETLink.dll) Version: 2.0.0.0

C#

public static IKernelLink CreateKernelLink(
	string[] argv
)

VB

Public Shared Function CreateKernelLink ( 
	argv As String()
) As IKernelLink

C++

public:
static IKernelLink^ CreateKernelLink(
	array<String^>^ argv
)

F#

static member CreateKernelLink : 
        argv : string[] -> IKernelLink

Parameters

argv String: The array of MathLink arguments.

Return Value

IKernelLink
The created link.

Remarks

Use this method if you want to specify the path to the kernel, or if you want to establish a listen/connect link instead of launching the kernel.

You can use standard MathLink/WSTP specifications for establishing a link, for example -linkprotocol, -linkname, and -linkmode.

An example of a string array argument would be:

C#

string[] mlArgs = {"-linkmode", "listen", "-linkname",  "foo"};
IKernelLink ml = MathLinkFactory.CreateKernelLink(mlArgs);

To avoid worries about quoting \ characters used in a pathname, use a forward slash (/) in the path:

C#

string[] mlArgs = {"-linkmode", "launch", "-linkname", "c:/path/to/my/Wolfram/WolframKernel.exe"};
IKernelLink ml = MathLinkFactory.CreateKernelLink(mlArgs);

Exceptions

MathLinkException

If the opening of the link fails.