WSGetUTF32Function （C 函数）

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

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

更多信息

  • WSGetUTF32Function() 分配对应于函数标头名称的字符字符串内存. 若要释放该内存，必须调用 WSReleaseUTF32Symbol(). 若 WSGetUTF32Function() 失败且函数的返回值说明存在错误，则不要调用有 s 内容的 WSReleaseUTF32Symbol().
  • 程序不应该修改字符字符串 s 的内容.
  • WSGetUTF32Function() 返回的字符字符串由一个适合平台的字节顺序标记开始. 该字节顺序标记包括在长度值 v 中.
  • WSGetUTF32Function(l, &s, &v, &n) 与 WSGetNext(l); WSGetArgCount(l, &n); WSGetUTF32Symbol(l, &s, &v) 的效果相同.
  • 若发生错误，则 WSGetUTF32Function() 返回0；若函数成功，则返回非零值.
  • 若 WSGetUTF32Function() 失败，则使用 WSError() 检索错误代码.
  • WSTP 的标头文件 wstp.h 已对 WSGetUTF32Function() 作出声明.

范例

基本范例  (1)

#include "wstp.h"

/* read a function from a link */

void f(WSLINK l)
{
    unsigned int *s;
    int length;
    int n;

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

    /* ... */

    WSReleaseUTF32Function(l, s, length);
}