MLPutMessageWithArg (C 関数)

MLPutMessageWithArgWSPutMessageWithArgに置き換えられた.

int MLPutMessageWithArg(MLINK link,int msg,int arg)

メッセージmsg とその引数arg をリンクオブジェクトlink に送信する.

詳細

  • MathLinkメッセージは,通常のデータの転送に関連していない帯域外メッセージの送信・受信を行う.
  • MLPutMessageWithArg()はエラーがあると0を返し, 関数が成功すると0以外の値を返す.
  • MLError()を使うと,MLPutMessageWithArg()が不成功の場合にエラーコードを引き出すことができる.
  • MLPutMessageWithArg()は,MathLinkヘッダファイルmathlink.hで宣言される.

例題

  (1)

#include "mathlink.h"


/* define some custom messages and arguments */

#define AppMenuMessage MLFirstUserMessage + 1

#define AppMenuOption1 1
#define AppMenuOption2 2

/* send an AppMenuMessage to a link */

void f(MLINK lp)
{
    if(! MLPutMessageWithArg(lp, AppMenuMessage, AppMenuOption2))
        { /* unable to send the message to lp */ }
}