#include <karacrix.h>
  main( argc, argv )
  int   argc;
  char *argv[];
  {
    int    flag;
     /*重要な部分1はここから*/
    char  *keyword [BUFSIZ];   /*キーワード読込文字列*/
    char  *paradata[BUFSIZ];   /*定義データ読込文字列*/
     /*ここまで*/
    int    mode_int;           /*使用したい整数変数名(例)*/
    double ondo_flt;           /*使用したい実数変数名(例)*/
    char   memo_txt[256];      /*使用したい文字列変数名(例)*/

      kcxinit( argc, argv );

      mode_int = 0;            /*整数変数に初期値[0]を設定(例)*/
      ondo_flt = 0.0;          /*実数変数に初期値[0.0]を設定(例)*/
      strcpy( memo_txt, "" );  /*文字列変数に初期値[空]を設定(例)*/

      /*重要な部分2はここから*/
      /*プログラムパラメータデータを読み込みキーワードの数を得る*/
      keywords = kcxprg_para_data_get( mode, keyword, paradata, BUFSIZ );

      if( keywords >= 1 ){  /*キーワードが存在していたらパラメータデータを取り込む*/
        for(i=0;i<keywords;i++){  /*キーワード数分を検査する*/
          if( strcmp( keyword[i], "xxx-mode" ) == 0 ){   /*キーワードが[xxx-mode(例)]の場合*/
            mode_int = atoi( paradata[i] );  /*パラメータ文字列データを整数に変換し取り込む*/
          }
          if( strcmp( keyword[i], "xxx-ondo" ) == 0 ){   /*キーワードが[xxx-ondo(例)]の場合*/
            ondo_flt = atof( paradata[i] );  /*パラメータ文字列データを実数に変換し取り込む*/
          }
          if( strcmp( keyword[i], "xxx-memo" ) == 0 ){   /*キーワードが[xxx-memo(例)]の場合*/
            strcpy( memo_txt, paradata[i] ); /*パラメータ文字列データを文字列のまま取り込む*/
          }
        }
      }
      /*ここまで*/

      /* 以下はパラメータデータ使用例 */
      flag = 0;
      if( mode_int >  100  )  flag = 1;            /*パラメータデータ取得後の操作イメージ*/
      if( ondo_flt >= 32.1 )  flag = 1;            /*パラメータデータ取得後の操作イメージ*/
      if( strcmp( memo_txt, "ok" ) == 0 )  flag = 1;  /*パラメータデータ取得後の操作イメージ*/
  }

 《解説》
  (1) キーワードと定義データ変数名は都合悪く無い限りこのままお使いください
      char *keyword [BUFSIZ];
      char *paradata[BUFSIZ]; 
      データはポインタ配列変数と言うもので、実体メモリのアドレスを格納します。
      この実体メモリの確保とアドレス設定は、kcxprg_para_data_get()関数内で行っています。
      したがって上記を制御プログラムで行う必要はありません。
      配列値としてのBUFSIZは、パラメータ数以上あれば良いですがBUFSIZ推奨です。 
  (2) kcxprg_para_data_get()関数のmodeと戻り値について
      a. mode が 0 の場合
       本関数初回実行時には、パラメータを読み取りそのキーワードの数を戻します。
       2回目以降は、パラメータが編集変更されていない限り、0を戻します。
       つまり、パラメータデータが不変でパラメータを再度読取る必要がないという意味です。
       パラメータ編集変更後本関数を実行すると、そのパラメータを読みキーワード数を戻します。
      b. mode が 1 の場合
       本関数実行時常に、パラメータを読み取りそのキーワードの数を戻します。
      ※本関数実行時パラメータファイルが存在しなかった場合mode値に関係なく-1を戻します。
  (2) atoi (アルファベットtoイント[整数]) とは
      文字列を整数値に変換する関数です。(注：文字列に整数文字以外を与えてはいけません)
      整数値 = atoi ( 文字列 );
  (3) atof (アルファベットtoフロート[実数]) とは
      文字列を倍精度実数値に変換する関数です。(注：文字列に実数文字以外を与えてはいけません)
      倍精度実数値 = atof ( 文字列 );
      double  f;
       f = atof( "3.14" );

  #include <karacrix.h>
  main( argc, argv )
  int   argc;
  char *argv[];
  {
    int   system_objid;
    int   do_objid;
    int   ai_objid;
    int   Ev_KEY;
    int   Ev_STAT;
    KcxIntFlt_t  udata10[10];

      kcxinit( argc, argv );

      system_objid = kcxobj_open( ".sys"  );
      do_objid     = kcxobj_open( "do001" );
      ai_objid     = kcxobj_open( "ai001" );

      /* システム操作履歴例 (ここではudata10を文字に使用、取り出しは$c0) */ 
      memset( (void *)udata10, 0, sizeof(udata10) );
      kcxstr_text_to_udata10( 0, "温度監視", "", udata10 );
      Ev_KEY  =  2;  /*例えば"プログラム"表示識別子*/
      Ev_STAT =  1;  /*例えば"起動"表示識別子      */
      kcxobj_ope_log_10uwt( system_objid, Ev_KEY, Ev_STAT, udata10 );

      /* 操作履歴例 (ここではudata10内容未使用、取り出しは無し)  */ 
      memset( (void *)udata10, 0, sizeof(udata10) );
      Ev_KEY  =  2;  /*例えば"操作"表示識別子*/
      Ev_STAT =  1;  /*例えば"ON"表示識別子  */
      kcxobj_ope_log_10uwt( do_objid, Ev_KEY, Ev_STAT, udata10 );

      /* 警報履歴例 (ここではudata10の実数1つ使用、取り出しは$f0) */ 
      memset( (void *)udata10, 0, sizeof(udata10) );
      udata10[0].f = 40.0; /*例えば異常値*/
      Ev_KEY      =   53; /*例えば"警報"表示識別子*/
      Ev_STAT     =    1; /*例えば"発生"表示識別子*/
      kcxobj_alm_log_10uwt( ai_objid, Ev_KEY, Ev_STAT, udata10 );

  }

 《解説》
  (1) memset()関数とは
      メモリを第二引数値で埋めるというものです。
      本プログラム例では、udata10 を使用する前に 0 クリアさせています。
  (2) kcxstr_text_to_udata10()関数とは
      udata10 は、半角文字 80 バイト分のメモリでこの範囲で文字が扱えます。
      80 バイト以上知らずに書き込むとプログラムエリア壊し誤動作するなど影響が出ます。
      本関数は、このサイズを超えないよう文字を udata10 に書き込む関数です。
      自作プログラムで、文字を udata10 に書き込むときは注意してください。
      引数は以下の通りです。第1と3引数は将来対応のもので今は0と""にしてください。
      kcxstr_text_to_udata10( 0, 書き込む文字列, "", udata10 );
  (3) KcxIntFlt_t の定義とは
      karacrixXXX/sys/sinc/kcxux_program.h の中で以下定義(抜粋)されています。
      typedef union _intflt_ {
	double     f;
	long long  i;
      } 
      KcxIntFlt_t;

HOME　戻る