WSLogStreamToFile （C 関数）

int WSLLogStreamToFile ( WSLINK l , const char * f )

l で指定されたWSTP接続のロギングをオンにして，f に指定されるファイルへのストリームの内容の記録を付ける．

詳細

  • ユーザは，許可なしに f に指定されたファイルに書き込むことはできない．
  • 同じストリームのログを複数のファイルに送ることができる．別のファイルに対するログの送信をする場合は，別のファイル名でもう一度WSLogStreamToFile()を呼び出す．
  • WSActivate()またはWSConnect()を呼び出す前に，WSLogStreamToFile()を呼び出してはならない．
  • WSLogStreamToFile()は，エラーがあった場合には0を，成功した場合には非零の値を返す．
  • WSLogStreamToFile()は，WSTPヘッダファイルwstp.hの中で宣言される．

例題

例  (1)

#include "wstp.h"

int main(int argc, char **argv)
{
    WSENV env;
    WSLINK link;
    int error;
    int apiResult;
    const char *fileName;

    env = WSInitialize((WSEnvironmentParameter)0);
    if(env == (WSENV)0)
    { /* Unable to create WSTP environment object */ }

    link = WSOpenArgcArgv(env, argc, argv, &error);
    if(link == (WSLINK)0 || error != WSEOK)
    { /* Unable to create link object */ }

    WSActivate(link);

    /* ... */

    apiResult = WSLogFileNameForLink(link, &fileName);
    if(! apiResult)
    { /* Unable to generate log file name */ }

    apiReuslt = WSLogStreamToFile(link, fileName);
    if(! apiResult)
    { /* Unable to log stream to file */ }

    WSReleaseLogFileNameForLink(link, fileName);

    /* ... */

    WSClose(link);
    WSDeinitialize(env);
}