WSOpenArgcArgv （C 関数）

WSLINK WSOpenArgcArgv(WSENV env,int argc,char** argv,int* errno)

コマンドライン引数からの変数を取りながら，WSTP接続を開く．

詳細

  • WSOpenArgcArgv()を呼び出す前に，WSInitialize()を呼び出さなければならない．
  • WSOpenArgcArgv()はコマンドライン引数を処理し，この引数をリンクの作成を制御するために使う．
  • WSOpenArgcArgv()は次のコマンドライン引数を認識する:
  • "-linkconnect"既存のリンクに接続する (LinkConnect)
    "-linkcreate"リンクを作成する (LinkCreate)
    "-linklaunch"子プロセスを起動する (LinkLaunch)
    "-linkname","name"リンクを開く際に使う名前
    "-linkprotocol","protocol"使用するリンクプロトコル（TCPIP，Pipes，SharedMemory，IntraProcess等）
  • WSOpenArgcArgv()は引数名の大文字，小文字を区別しない．
  • WSOpenArgcArgv()は認識しない引数名を無視する．
  • WSOpenArgcArgv()は，wsprepとwsccで作成されたWSMain()関数によって自動的に呼び出される．
  • コンピュータシステムによっては，argc に0を，あるいは argv に空ポインタを与えることによって，通常ダイアログボックスを通して，引数が対話形式で要求されることもある．
  • WSOpenArgcArgv()は，WSTPヘッダファイルwstp.hの中で宣言される．

例題

例  (1)

#include "wstp.h"

/* create a link using command-line parameters */

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

    env = WSInitialize((WSEnvironmentParameter)0);
    if(env == (WSENV)0)
        { /* unable to initialize the WSTP environment */ }

    /* let WSOpenArgcArgv process the command line */
    link = WSOpenArgcArgv(env, argc, argv, &error);
    if(link == (WSLINK)0 || error != WSEOK)
        { /* unable to create the link */ }

    /* ... */

    WSClose(link);
    WSDeinitialize(env);

    return 0;
}