WSUTF8ErrorMessage （C 函数）

const unsigned char * WSUTF8ErrorMessage(WSLINK l, int *n)

返回一个由 UTF-8 字符编码形式编码、长度为 n 的字符串，描述由 l 指定的 WSTP 连接上发生的最后一个错误.

更多信息

  • WSUTF8ErrorMessage() 为必须释放的消息字符串而分配内存. 使用 WSReleaseUTF8ErrorMessage() 来释放由 WSUTF8ErrorMessage() 分配的内存. 若 WSUTF8ErrorMessage() 返回 NULL，则不要使用 NULL 值调用 WSReleaseUTF8ErrorMessage().
  • 程序不应修改字符串的内容.
  • WSTP 的标头文件 wstp.h 已对 WSUTF8ErrorMessage() 作出声明.

范例

基本范例  (1)

#include "wstp.h"

/* A function for reading the error message of a link */

void f(WSLINK l)
{
    const unsigned char *message;
    int length;

    message = WSUTF8ErrorMessage(l, &length);

    if(message == (const unsigned char *)0 || length == 0)
    { /* Unable to read the error message from the link */ }

    /* ... */

    WSReleaseUTF8ErrorMessage(l, message, length);
}