WSGetUCS2Function （C 函数）

int WSGetUSC2Function( WSLINK l , const unsigned short ** s , int * v , int * n )

从由 l 指定的 WSTP 连接中获取函数，该函数带有用 UCS2 编码形式来编码的作为标头的符号，该符号的名称存于 s，UCS2 代码的长度存于 v，函数参数的数量存于 n.

更多信息

  • WSGetUCS2Function() 分配对应于函数标头名称的字符字符串内存. 若要释放该内存，必须调用 WSReleaseUCS2Symbol(). 若 WSGetUCS2Function() 失败且函数的返回值说明存在错误，则不要调用有 s 内容的 WSReleaseUCS2Symbol().
  • 程序不应修改字符字符串 s 的内容.
  • WSGetUCS2Function(l, &s, &v, &n) 与 WSGetNext(l); WSGetArgCount(l, &n); WSGetUCS2Symbol(l, &s, &i)的效果相同.
  • 若发生错误，则 WSGetUCS2Function() 返回0；若函数成功，则返回非零值.
  • 若 WSGetUCS2Function() 失败，可使用 WSError() 来检索错误代码.
  • WSTP 的标头文件 wstp.h 已对 WSGetUCS2Function() 作出声明.

范例

基本范例  (1)

#include "wstp.h"

/* read a function from a link */

void f(WSLINK l)
{
    const unsigned short *s;
    int codes;
    int n;

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

    /* ... */

    WSReleaseUCS2Symbol(l, s, codes);
}