Wolfram Language & System 11.0 (2016)|Legacy Documentation

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

WSOpenString()
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.

DetailsDetails

  • 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 */ }

    /* ... */

    WSClose(link);
    WSDeinitialize(env);

    return 0;
}