WSTestUTF16HeadWithArgCount （C 函数）

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

检验由 l 指定的 WSTP 连接读取的下一个对象是否为一个标头为 s 的表达式，一个长度为 v 的 UTF-16 编码的字符字符串，并测试表达式参数的数量为 n.

更多信息

  • 若链接上当前表达式并非以符号作为标头的函数，或该符号的名称与 s 不相符，或函数参数的数量不是 n，则 WSTestUTF16HeadWithArgCount() 失败.
  • 函数返回时，则 WSTestUTF16HeadWithArgCount() 会在 n 中储存函数参数的实际数量.
  • 编码为一个 UTF-16 字符串的符号 s 必须由一个字节顺序标记（byte order mark）开始.
  • 符号 v 必须包括该字节顺序标记.
  • 若发生错误，则 WSTestUTF16HeadWithArgCount() 返回0；若函数成功，则返回非零值.
  • 若 WSTestUTF16HeadWithArgCount() 失败，则使用 WSError() 检索错误代码.
  • 若函数失败，则 WSTestUTF16HeadWithArgCount() 会恰好在调用 WSTestUTF16HeadWithArgCount() 之前重置链接上表达式的流指针（stream pointer）. 这个操作表现得就像程序员调用 WSCreateMark(l); WSTestUTF16HeadWithArgCount(...); WSSeekToMark(...) 一样.
  • WSTP 的标头文件 wstp.h 已对 WSTestUTF16HeadWithArgCount() 作出声明.

范例

基本范例  (1)

#include "wstp.h"

/* A function to test whether the next expression on the Link is Plus[a,b] */

void f(WSLINK l)
{
    unsigned short symbol[5];
    int args = 2;
    const char *symbol;

    symbol[0] = 0xFEFF;
    symbol[1] = 'P';
    symbol[2] = 'l';
    symbol[3] = 'u';
    symbol[4] = 's';

    if(! WSTestUTF16HeadWithArgCount(l, (const unsigned short *)symbol, 5, &args))
    { /* Next expression is not Plus, or does not have two args */ }

    if(! WSGetSymbol(l, &symbol))
    { /* Unable to read symbol */ }

    /* Check if symbol is 'a' */

    WSReleaseSymbol(l, symbol);

    if(! WSGetSymbol(l, &symbol))
    { /* Unable to read symbol */ }

    /* Check if the symbol is 'b' */

    WSReleaseSymbol(l, symbol);
}