Thread ライブラリ


概要 - Abstract

VCSSL Thread ライブラリ は、マルチスレッドを扱うための標準ライブラリです。

- 注意 -
現行版の RINEARN VCSSL Runtime では、VCSSL Thread APIをサポートしていますが、マルチスレッド処理への対応が十分ではありません。 これは、現在のVCSSLエンジンの基本設計が、シングルスレッドのみを想定して開発された初期のVCSSLエンジンの基本設計を、部分的に踏襲している事に由来します。 これにより、処理内容によっては、論理的な不整合を含む、いくつかの不都合が生じる可能性があります。 RINEARN VCSSL Runtime で VCSSL Thread API の使用を検討する場合は、この事情を踏まえた上で判断してください。現時点で想定可能なものとしては、以下のような不都合が生じる可能性があります。
・同一の配列変数へ、複数スレッドから同時アクセスした場合における、インデックスの不整合
現在のVCSSLエンジンにおける、配列変数の値を参照するモジュールには、シングルスレッドのみを想定した設計が残っています。これにより、同一の配列変数に、同時にアクセスした場合、正しくないインデックスの値が参照される可能性があります。
・パフォーマンスのボトルネック
現在のVCSSLエンジンには、マルチスレッド処理ではボトルネックとなる箇所を複数含んでいます。このため、並列性の高い処理を複数スレッドで分担しても、パフォーマンスの大幅な向上は見込めません。 つまり、RINEARN VCSSL Runtime における Thread API は、あくまで複数の処理の流れを作る目的には有効ですが、演算パフォーマンスを引き出すような目的にはあまり意味がありません。
・同一の関数への、非常に頻繁な複数スレッド同時アクセスに伴う、エンジンの緊急停止
原則として、同一の関数を複数スレッドで実行する事は可能です。その場合、引数やローカル変数は、スレッド間で混同されないように、スレッドの数だけ確保されます。 しかし、同時アクセスのタイミングがあまりに短い間隔に集中すると、この処理が追いつかなくなり、不整合を防ぐためにエンジンが緊急停止する場合があります。 ※ 関数の実行中の時間が重なる事は問題ではありません。関数をコールする瞬間(引数を渡す瞬間)が重なる事が問題となります。
以上のような不都合が生じる可能性があるため、現状の RINEARN VCSSL Runtime では、VCSSL Thread APIを厳密性の要求される処理(科学技術計算や数値計算など)に使用する事は推奨されません。

目次 - Index

int newThread()
スレッドを生成し、それに固有の識別番号である「スレッドID」を割り振って返します。
void deleteThread( int threadID )
スレッドを破棄します。
void startThread( int threadID )
スレッドの実行を開始します。
void awaitThread( int threadID )
スレッドの実行が終了するまで、呼び出し元の処理を待機します。
void sleepThread( int threadID, int time )
スレッドの実行を一時停止します。
void sleepThread( int threadID, int milliSeconds, nanoSeconds )
スレッドの実行を一時停止します。
void waitForThread( int threadID )
スレッドの実行が終了するまで、呼び出し元の処理を待機します。現在は、より新しい awaitThread が利用可能です。この関数は互換目的でサポートされています。
void onThreadStart( int threadID )
スレッドが生成され、実行が開始した時にコールされます。この関数は、生成されたスレッドの処理として実行されます。ここに、スレッドに行わせたい処理を実装します。
void onThreadEnd( int threadID )
スレッドの処理が終了した時にコールされます。

構造体 - Structs

- なし - None -


変数 - Variables

- なし - None -


関数 - Functions

定義
- Signature
int newThread()
詳細
- Details
スレッドを生成し、それに固有の識別番号である「スレッドID」を割り振って返します。
戻り値
- Return
生成したスレッドに割り振られたスレッドID(識別番号)
定義
- Signature
void deleteThread( int threadID )
詳細
- Details
スレッドを破棄します。
引数
- Arguments
threadID : 対象スレッドのID
定義
- Signature
void startThread( int threadID )
詳細
- Details
スレッドの実行を開始します。
引数
- Arguments
threadID : 対象スレッドのID
定義
- Signature
void awaitThread( int threadID )
詳細
- Details
スレッドの実行が終了するまで、呼び出し元の処理を待機します。
引数
- Arguments
threadID : 対象スレッドのID
定義
- Signature
void sleepThread( int threadID, int time )
詳細
- Details
スレッドの実行を一時停止します。
引数
- Arguments
threadID : 対象スレッドのID
time : 待機する時間のミリ秒数
定義
- Signature
void sleepThread( int threadID, int milliSeconds, nanoSeconds )
詳細
- Details
スレッドの実行を一時停止します。
引数
- Arguments
threadID : 対象スレッドのID
milliSeconds : 待機する時間のミリ秒数
nanoSeconds : 待機する時間のナノ秒数
定義
- Signature
void waitForThread( int threadID )
詳細
- Details
スレッドの実行が終了するまで、呼び出し元の処理を待機します。現在は、より新しい awaitThread が利用可能です。この関数は互換目的でサポートされています。
引数
- Arguments
threadID : 対象スレッドのID

イベントハンドラ - Event Handler

定義
- Signature
void onThreadStart( int threadID )
詳細
- Details
スレッドが生成され、実行が開始した時にコールされます。この関数は、生成されたスレッドの処理として実行されます。ここに、スレッドに行わせたい処理を実装します。
引数
- Arguments
threadID : イベント発生元スレッドのID
定義
- Signature
void onThreadEnd( int threadID )
詳細
- Details
スレッドの処理が終了した時にコールされます。
引数
- Arguments
threadID : イベント発生元スレッドのID


スポンサーリンク



スポンサーリンク

この階層の目次
お知らせ

各ソフトウェアの最新版を一括でリリース、OpenJDKのJava実行環境(JRE)に対応
2019年03月06日 - RINEARNでは3月6日に、主要なソフトウェアの最新版を一括でリリースしました。今回のアップデートには、以前お知らせした、OpenJDKで生成したJREへの対応が含まれています。その概要等をお知らせします。

次回のVCSSL 3.4.10において、関数1個の挙動に非互換な修正が適用されます
2019年02月12日 - VCSSLの次回の正式リリース版3.4.10において、これまでドキュメントと実際の挙動が異なっていた描画系の関数1個に、非互換な修正が適用されます。その詳細と、使用コードでの対応方法について解説します。

RINEARNのソフトウェア向けにOpenJDKで生成したJava実行環境(JRE)の提供を開始
2019年02月06日 - Javaのリリースモデル変更への対応として、OpenJDKのjlinkツールを用いて、RINEARNのソフトウェア実行用に生成したJava実行環境(JRE)の提供を開始しました。その詳細と、今後の方針について解説します。

新着
画像の矩形(四角形)領域を切り抜く簡易ツール(複数ファイル一括処理版)

フォルダ内にある全ての画像ファイルを開き、その中の矩形(四角形)領域を切り抜いて、別のフォルダに保存する簡易ツールです。
2019年03月15日
画像の矩形(四角形)領域を切り抜く簡易ツール

画像ファイルを開き、その中の矩形(四角形)領域を切り抜いて保存する簡易ツールです。
2019年03月14日
入力された数式を積分して値とグラフを表示するツール

画面上で数式を入力すると、それを数値的に積分し、値とグラフを表示してくれるGUIツールです。
2019年01月20日
z = f(x,y,t) の形の数式を3Dグラフとしてアニメーション描画するツール

入力欄に z = f(x,y,t) の形の数式を入力すると、それを3次元のグラフにアニメーション描画してくれる簡易ツールです。
2018年11月26日
y = f(x,t) の形の数式を2Dグラフとしてアニメーション描画するツール

入力欄に y = f(x,t) の形の数式を入力すると、それを2次元のグラフにアニメーション描画してくれる簡易ツールです。
2018年11月25日
開発元Twitterアカウント