MLGetUTF16Function （C 関数）

MLGetUTF16FunctionはWSGetUTF16Functionに置き換えられた．

int MLGetUTF16Function( MLINK l , const unsigned short * s , int * v , int * n )

l が指定するMathLink接続からのUTF-16のコード化形式でコード化された頭部として，記号を含む関数を得て，記号の名前を s に，UTF-16コードの長さを v に，関数の引数の数を n に保存する．

詳細

  • MLGetUTF16Function()は，関数の頭部の名前に対応する文字列にメモリを割り当てる．このメモリを解放するためには，MLReleaseUTF16Symbol()を呼び出さなければならない．MLGetUTF16Function() が失敗し，関数の戻り値がエラーを示す場合には，s の内容に対してMLReleaseUTF16Symbol()を呼び出してはならない．
  • プログラムは，文字列 s の内容を変更してはならない．
  • MLGetUTF16Function()によって返された文字列は，プラットフォームに適切なバイトオーダーマークで始まる．このバイトオーダーマークは，長さの値 v に含まれる．
  • MLGetUTF16Function(l, &s, &v, &n)は，MLGetNext(l); MLGetArgCount(l, &n); MLGetUTF16Symbol(l, &s, &v, &c)と同じ効果がある．その場合，c は s でコード化されている文字の数である．
  • MLGetUTF16Function()は，エラーがあった場合には0を返し，関数が成功した場合には非零の値を返す．
  • MLGetUTF16Function()が失敗した場合には，MLError()を使ってエラーコードを得るとよい．
  • MLGetUTF16Function()は，MathLinkヘッダファイルmathlink.hで宣言される．

例題

例  (1)

#include "mathlink.h"

/* A function for reading a Mathematica function from a link */

void f(MLINK l)
{
    const unsigned short *s;
    int length;
    int n;

    if(! MLGetUTF16Function(l, &s, &length, &n))
    { /* Unable to read the function from the link */ }

    /* ... */

    MLReleaseUTF16Symbol(l, s, length);
}