WSBytesToGet （C 関数）

int WSBytesToGet(WSLINK link,int *n)

現行データのテキスト表現の中で読み取るのに残されたバイト数を計算し，その結果をn に保存する．

詳細

  • WSTPはリンク上の読み取り可能なデータをその進行中のリンク表示以外のタイプに変換することができる. WSBytesToGet()は現行データを文字列表示に変換する.
  • WSBytesToGet()はエラーがあると0を返し，関数が成功すると0以外の値を返す.
  • WSError()を使うと， WSBytesToGet()が不成功の場合にエラーコードを引き出すことができる.
  • WSBytesToGet()は，WSTPヘッダファイルwstp.hの中で宣言される．

例題

例  (1)

#include <stdlib.h>
#include <string.h>
#include "wstp.h"

/* check the incoming string size to allocate enough memory to store the string */

void f(WSLINK lp)
{
    int incoming_bytes;
    char *string;
    const char *wsstring;

    switch(WSGetType(lp))
    {
        case WSTKSTR:
            if(! WSBytesToGet(lp, &incoming_bytes))
                { /* unable to get the size of the string */ }

            string = (char *)malloc(incoming_bytes + 1);
            if(string == (char *)0)
                { /* memory allocation failed */ }

            if(! WSGetString(lp, &wsstring))
                { /* unable to get the string from lp */ }

            memcpy(string, wsstring, incoming_bytes);

            *(string + incoming_bytes) = '\0';

            break;
        /* ... */
    };

    /* ... */
}