WSTestUTF16Head （C 函数）

int WSTestUTF16Head(WSLINK l, const unsigned short *h, int v, int *n)

检验从 l 读取的下一个表达式是否为一个标头为 h 的表达式和一个长度为 v 的 UTF-16 编码名称，并在 n 中储存表达式参数的数量.

更多信息

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

范例

基本范例  (1)

#include "wstp.h"

/* A function for testing whether the next expression on the link is a ReturnPacket[] */

void f(WSLINK l)
{
    const unsigned short packet[13];
    int arguments;

    packet[0] = 0xFEFF;
    packet[1] =  'R';
    packet[2] =  'e';
    packet[3] =  't';
    packet[4] =  'u';
    packet[5] =  'r';
    packet[6] =  'n';
    packet[7] =  'P';
    packet[8] =  'a';
    packet[9] =  'c';
    packet[10] =  'k';
    packet[11] = 'e';
    packet[12] = 't';

    if(! WSTestUCS2Head(l, (const unsigned short *)packet, 13,
        &arguments))
    { /* read the contents of the ReturnPacket[] */ }
    else
    { /* the head of the incoming expression is not ReturnPacket */ }
}