WSOpenString (C Function)

WSLINK WSOpenString(WSENV env,const char *string,int *errno)

opens a WSTP connection taking parameters from a character string.

Details

  • 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.

Examples

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;
}