bool GlobalVariableSetOnCondition(string name, double value, doublecheck_value)
Sets the new value of the existing global variable if the current value equals to the third parameter check_value. If there is no global variable, the function will generate errorERR_GLOBAL_VARIABLE_NOT_FOUND (4058) and return FALSE. When successfully executed, the function returns TRUE, otherwise, it returns FALSE. To get the detailed error information, one has to call the GetLastError() function.
現在の値が、3番目のパラーメータ check_value に等しい場合、既存のグローバル変数に新しい値を設定します。もし、グローバル変数がない場合は、関数はエラー ERR_GLOBAL_VARIABLE_NOT_FOUND (4058) を生成し、FALSE を返します。正常に実行されたときは、関数は TRUE を返します。それ以外の場合は、FALSE を返します。詳細なエラー情報を取得するには、GetLastError() を呼び出します。
If the current value of the global variable differs from the check_value, the function will return FALSE.
グローバル変数が現在の値と check_value と異なる場合は、この関数は FALSE を返します。
The function provides atomic access to the global variable, this is why it can be used for providing of a semaphore at interaction of several experts working simultaneously within one client terminal.
この関数は、グローバル変数への微少アクセスを提供します。これは、１つのクライアント ターミナルの中で同時処理されているいくつかのエキスパートの相互作用のときに、セマフォ（割り込み処理を制御し、同時アクセスによる不整合を防止）を提供するために使用することができます。
Parameters:
パラメータ：
1 2 3 4 5 6 7 8 | <b>name</b> - Global variable name. グローバル変数の名前。 <b>value</b> - New value. 新しい値。 <b>check_value</b> - Value to be compared to the current global variable value. 現在のグローバル変数の値を比較する値。 |
Sample:
サンプル：
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 | int init() { //---- create global variable GlobalVariableSet("DATAFILE_SEM",0); //... } int start() { //---- try to lock common resource while(!IsStopped()) { //---- locking if(GlobalVariableSetOnCondition("DATAFILE_SEM",1,0)==true) break; //---- may the variable be deleted? if(GetLastError()==ERR_GLOBAL_VARIABLE_NOT_FOUND) return(0); //---- sleeping Sleep(500); } //---- resource locked // ... do some work //---- unlock resource GlobalVariableSet("DATAFILE_SEM",0); } |