Difference between revisions of "love.thread (日本語)"

m (関連)
m (Bit improved description.)
Line 1: Line 1:
 
{{newin (日本語)|[[0.7.0]]|070|type=module}}
 
{{newin (日本語)|[[0.7.0]]|070|type=module}}
スレッドを使用して作業を行えるようにします。
+
スレッドを使用して作業を分担できるようにします。
  
スレッドはメインコードとは個別に独立した Lua 環境であり、メインコードと並列で実行されます。スレッドのコードは別々に実行されるため、メイン・スレッドのフレーム・レートに悪影響を与えることなく複雑な計算作業を処理するために使用することができますが、スレッドは個々に独立した環境である関係でメイン・スレッドに存在する変数および関数にはアクセスできませんので、スレッド間の通信は制限されています。
+
スレッドはメインコードとは個別に独立した Lua 環境であり、メインコードと並列で実行されます。スレッドのコードは別々に実行される関係で、メイン・スレッドのフレーム・レートに悪影響を与えることなく複雑な計算作業を処理するために使用することができます。しかし、スレッドは個々に独立した環境である関係でメイン・スレッドに存在する変数および関数にはアクセスできませんので、スレッド間の通信は制限されています。
  
全ての LÖVE オブジェクト (userdata) はスレッドを経由して参照物を送信する場合に限り、スレッド間で共有されます。複数のスレッドで同時にオブジェクトを操作する場合に起きる並列性の問題は発生してもかまいません。
+
全ての LÖVE オブジェクト (userdata) はスレッドを経由してオブジェクトを送信する場合に限り、スレッド間で共有されます。複数のスレッドで同時にオブジェクトを操作する場合に起きる並列性の問題は発生しても問題はありません。
  
[[Thread (日本語)|Thread]] を開始したときは、 love.thread モジュールのみ読み込まれます。 その他のモジュールは [[require (日本語)|require]] により別々に読み込む必要があります。
+
[[Thread (日本語)|スレッド]]の開始時に love.thread モジュールのみ読み込まれます。 その他のモジュールは [[require (日本語)|require]] により別々に読み込む必要があります。
  
 
{{notice|[[love.graphics (日本語)|love.graphics]] および [[love.window (日本語)|love.window]] モジュールには一部制限があるためメインスレッドのみで使用できます。}}
 
{{notice|[[love.graphics (日本語)|love.graphics]] および [[love.window (日本語)|love.window]] モジュールには一部制限があるためメインスレッドのみで使用できます。}}
{{notice|[[love.threaderror (日本語)|love.threaderror]] コールバックを定義するか [[Thread:getError (日本語)|Thread:getError]] を呼び出すまでスレッドのコードが投げてくるエラーを参照できません。}}
+
{{notice|[[love.threaderror (日本語)|love.threaderror]] コールバックを定義するか [[Thread:getError (日本語)|Thread:getError]] を呼び出すまでスレッドのコードが投げてくるエラーは参照できません。}}
  
 
== 型 ==
 
== 型 ==
Line 34: Line 34:
 
}}
 
}}
 
[[Category:Modules]]
 
[[Category:Modules]]
{{#set:Description=スレッドを使用して作業を行えるようにします。}}
+
{{#set:Description=スレッドを使用して処理を分担できるようにします。}}
 
{{#set:Since=070}}
 
{{#set:Since=070}}
 
== 用例 ==
 
== 用例 ==

Revision as of 08:44, 19 October 2017

LÖVE 0.7.0 から使用可能
このmoduleは以前のバージョンでは非対応です。

スレッドを使用して作業を分担できるようにします。

スレッドはメインコードとは個別に独立した Lua 環境であり、メインコードと並列で実行されます。スレッドのコードは別々に実行される関係で、メイン・スレッドのフレーム・レートに悪影響を与えることなく複雑な計算作業を処理するために使用することができます。しかし、スレッドは個々に独立した環境である関係でメイン・スレッドに存在する変数および関数にはアクセスできませんので、スレッド間の通信は制限されています。

全ての LÖVE オブジェクト (userdata) はスレッドを経由してオブジェクトを送信する場合に限り、スレッド間で共有されます。複数のスレッドで同時にオブジェクトを操作する場合に起きる並列性の問題は発生しても問題はありません。

スレッドの開始時に love.thread モジュールのみ読み込まれます。 その他のモジュールは require により別々に読み込む必要があります。

O.png love.graphics および love.window モジュールには一部制限があるためメインスレッドのみで使用できます。  


O.png love.threaderror コールバックを定義するか Thread:getError を呼び出すまでスレッドのコードが投げてくるエラーは参照できません。  


Channel (日本語) このオブジェクトは別のスレッド間でデータの送信および受信に使用できます。 Added since 0.9.0
Thread (日本語) Thread はスレッドを提供します。 Added since 0.7.0

関数

love.thread.getChannel (日本語) 名前ありスレッドのチャンネルを作成または検索します。 Added since 0.9.0
love.thread.getThread (日本語) スレッドを検索してオブジェクトを取得します。 Added since 0.7.0 Removed in 0.9.0
love.thread.getThreads (日本語) 全てのスレッドを取得します。 Added since 0.7.0 Removed in 0.9.0
love.thread.newChannel (日本語) 名前なしスレッドのチャンネルを新規作成します。 Added since 0.9.0
love.thread.newThread (日本語) ファイル名、文字列または Lua コードのある FileData オブジェクトからスレッドを新規作成します。 Added since 0.7.0


用例

LÖVE 0.9.0 用: http://love2d.org/forums/viewtopic.php?f=4&t=76670

関連

そのほかの言語