WSTestUTF8Symbol （C 函数）

int WSTestUTF8Symbol(WSLINK l, const unsigned char *s, int n)

检验由 l 指定的 WSTP 连接上的下一个表达式是否为一个值为 s 的符号，一个长度为 n 的 UTF-8 编码的字符串.

更多信息

  • 若链接 l 上的当前表达式并非符号，或符号的值与 s 不相符，则 WSTestUTF8Symbol() 失败.
  • 若发生错误，则 WSTestUTF8Symbol() 返回0；若函数成功，则返回非零值.
  • 若 WSTestUTF8Symbol() 失败，则使用 WSError() 检索错误代码.
  • 若函数失败，则 WSTestUTF8Symbol() 会恰好在调用 WSTestUTF8Symbol()之前重置链接上表达式的流指针（stream pointer）. 这个操作表现得像是程序员调用了 WSCreateMark(link); WSTestUTF8Symbol(…); WSSeekToMark(…) 一样.
  • WSTP 的标头文件 wstp.h 已对 WSTestUTF8Symbol() 作出声明.

范例

基本范例  (1)

#include "wstp.h"

/* A function for testing the next symbol on the link */

void f(WSLINK l)
{
    const unsigned char theSymbol[5];

    theSymbol[0] = 'L';
    theSymbol[1] = 'i';
    theSymbol[2] = 's';
    theSymbol[3] = 't';

    if(! WSTestUTF8Symbol(l, (const unsigned char *)theSymbol,
        4))
    { /* The next expression on the link is not List */ }
    else
    { /* The next expression on the link is List */ }
}