WSReleaseUTF32ErrorMessage (C 函数)

void WSReleaseUTF32ErrorMessage(WSLINK l, const unsigned int *m, int n)

释放由 WSUTF32ErrorMessage() 分配的内存,以在 m 中储存 UTF-32 编码消息,m 为一个长度为 n 的数组.

更多信息

  • 被分配来储存消息 m 的内存肯定已在调用 WSUTF32ErrorMessage() 时就被分配.
  • WSTP 的标头文件 wstp.h 已对 WSReleaseUTF32ErrorMessage() 作出声明.

范例

基本范例  (1)

#include "wstp.h"

/* A function for reading an error message from a link */

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

    message = WSUTF32ErrorMessage(l, &length);

    /* We check for length <= 1 here because WSUTF32ErrorMessage
    returns a string with a byte order mark. */

    if(message == (const unsigned int *)0 || length <= 1)
    { /* Unable to get the error message from the link */ }

    /* ... */

    WSReleaseUTF32ErrorMessage(l, message, length);
}