MLPutRawSize （C 関数）

MLPutRawSizeはWSPutRawSizeに置き換えられた．

int MLPutRawSize(MLINK link, int s)

長さがs バイトの未加工の文字データあるいは数値データを受け取ることができるようにlink の準備をする．

詳細

  • MLPutRawSize()をMLPutType()，MLPutRawData()と一緒に使うと，MLPutInteger32()あるいは MLPutUTF8String()等の型特定のAPI関数を使わずに手入力でデータをリンクに置くことができる．
  • MLPutRawSize()はエラーがあると0を返し，関数が成功するとゼロ以外の値を返す．
  • MLError()を使うと，MLPutRawSize()が不成功の場合にエラーコードを引き出すことができる．
  • MLPutRawSize()は，MathLinkヘッダファイルmathlink.hの中で宣言される．

例題

例  (1)

#include "mathlink.h"

/* send a function as raw data to a link */

void f(MLINK lp)
{
    int a = 2, b = 3;

    if(! MLPutType(lp, MLTKFUNC))
        { return; /* unable to put the function type to lp */ }

    if(! MLPutArgCount(lp, 2))
        { return; /* unable to put the number of arguments to lp */ }

    if(! MLPutType(lp, MLTKOLDSYM))
        { return; /* unable to put function head type to lp */ }
    
    if(! MLPutRawSize(lp, 4))
        { return; /* unable to put the size of the symbol to lp */ }

    if(! MLPutRawData(lp, (const unsigned char *)"Plus", 4))
        { return; /* unable to put the raw bytes to lp */ }

    if(! MLPutType(lp, MLTK_CINT))
        { return; /* unable to put the argument type to lp */ }

    if(! MLPutRawSize(lp, sizeof(int)))
        { return; /* unable to put the size of the integer to lp */ }

    if(! MLPutRawData(lp, (const unsigned char *)&a, sizeof(a)))
        { return; /* unable to put the raw bytes of a to lp */ }

    if(! MLPutType(lp, MLTK_CINT))
        { return; /* unable to put the second argument type to lp */ }

    if(! MLPutRawSize(lp, sizeof(int)))
        { return; /* unable to put the size of the integer to lp */ }

    if(! MLPutRawData(lp, (const unsigned char *)&b, sizeof(b)))
        { return; /* unable to put the raw bytes of b to lp */ }
}