WSTestUTF32String （C 函数）

int WSTestUTF32String(WSLINK l, const unsigned int *s, int n)

检验将要从 l 读取的下一个表达式是否为一个值为 s 的字符串，一个长度为 n 的 UTF-32 编码的字符串.

更多信息

  • 若链接上的当前对象并非一个字符串，或字符串的值与 s 不相符，则 WSTestUTF32String() 失败.
  • 若发生错误，则 WSTestUTF32String() 返回0；若函数成功，则返回非零值.
  • 若 WSTestUTF32String() 失败，则使用 WSError() 检索错误代码.
  • 若函数失败，则 WSTestUTF32String() 会恰好在调用 WSTestUTF32String() 之前重置链接上表达式的流指针（stream pointer）. 这个操作表现得就像程序员调用了 WSCreateMark(link); WSTestUTF32String(…); WSSeekToMark(…) 一样.
  • 该 UTF-32 编码的字符串 s 必须包括一个字节顺序标记（byte order mark）.
  • 该 UTF-32 字符串 s 的长度 n 必须包括这个字节顺序标记（byte order mark）.
  • WSTP 的标头文件 wstp.h 已对 WSTestUTF32String() 作出声明.

范例

基本范例  (1)

#include "wstp.h"

/* A function for testing the next expression on the link for a string */

void f(WSLINK l)
{
    const unsigned int theString[9];

    theString[0] = 0xFEFF;
    theString[1] = '$'
    theString[2] = 'V';
    theString[3] = 'e';
    theString[4] = 'r';
    theString[5] = 's';
    theString[6] = 'i';
    theString[7] = 'o';
    theString[8] = 'n';

    if(! WSTestUTF32String(l, (const unsigned int *)theString,
        9))
    { /* The next expression on the link is not $Version */ }
    else
    { /* The next expression on the link is $Version */ }
}