WSLoopbackOpen （C 関数）

WSLINK WSLoopbackOpen(WSENV env,int *errno)

ループバックのWSTP接続を開く．

詳細

  • WSTPテンプレートで設定された外部プログラムでは，環境stdenv が使用されるべきである．
  • ループバックリンクを使うと，Wolfram言語の式を効率よく保持することができる．
  • ループバックリンクに書かれた任意の式は，同じリンクオブジェクトからの読取りが可能である．
  • WSLoopbackOpen()はそのエラー結果をerrno に保持する．エラーが起こらない場合は，errno はWSEOKを含む．
  • WSLoopbackOpen()は，WSTPヘッダファイルwstp.hの中で宣言される．

例題

例  (1)

#include "wstp.h"

/* read data from a link, store it in a loopback link, and return the loopback link */

WSLINK f(WSENV env, WSLINK link)
{
    WSLINK loopbacklink;
    int error;

    loopbacklink = WSLoopbackOpen(env, &error);
    if(loopbacklink == (WSLINK)0 || error != WSEOK)
        { /* unable to create loopbacklink */ }

    if(! WSTransferExpression(loopbacklink, link))
        { /* unable to transfer an expression from link to
             loopbacklink */ }

    return loopbacklink;    
}