Wolfram Language & System 10.4 (2016)|Legacy Documentation

This is documentation for an earlier version of the Wolfram Language.View current documentation (Version 11.2)

This feature is not supported on the Wolfram Cloud.

WSLINK WSOpenString(WSENV env,const char *string,int *errno)
opens a WSTP connection taking parameters from a character string.


  • WSInitialize() must be called before WSOpenString.
  • WSOpenString() takes a single string instead of the array used by WSOpenArgcArgv().
  • Arguments in the string are separated by spaces.
  • On some computer systems, giving NULL in place of the string pointer will cause arguments to be requested interactively, typically through a dialog box.
  • WSOpenString() is declared in the WSTP header file wstp.h.

ExamplesExamplesopen allclose all

Basic Examples  (1)Basic Examples  (1)

#include "wstp.h"

int main()
    WSENV env;
    WSLINK link;
    int error;

    env = WSInitialize((WSEnvironmentParameter)0);
    if(env == (WSENV)0)
        { /* unable to initialize WSTP environment */ }

    link = WSOpenString(env, "/usr/local/bin/math -mathlink", &error);
    if(link == (WSLINK)0 || error != WSEOK)
        { /* unable to create link to the Kernel */ }

    /* ... */


    return 0;