クエリ:t > クエリ:thread > バージョン:3.0

THREADコマンドを送り、メールボックスを検索した結果を
スレッド形式の木構造で返します。

THREAD コマンドは 5256 で定義されています。
詳しくはそちらを参照してください。
このコマンドは Net::IMAP#capability の返り値を見ることで
利用可能かどうか判断できます。

algorithm は木構造を決定するためのアルゴリズムを指定します。
以下の2つが利用可能です。
* "ORDEREDSUBJECT" subjectを使って平坦に区切るだけ
* "REFERENCES" どのメッセージに返事をしているかを見て木構造を作る
詳しくは 5256 を見てく...

IRB::Context#thread -> Thread (73225.0)

インスタンスメソッド

現在のスレッドを返します。

現在のスレッドを返します。

@see Thread.current

絞り込み条件を変える

DRb.#thread -> Thread|nil (73207.0)

モジュール関数

プライマリサーバが動作しているスレッドを返します。

プライマリサーバが動作しているスレッドを返します。

プライマリサーバが存在しない場合は nil を返します。

@see DRb.#primary_server

DRb::DRbServer#thread -> Thread (73207.0)

インスタンスメソッド

サーバのメインスレッドを返します。

サーバのメインスレッドを返します。

このスレッドはクライアントからの接続を受け付けるスレッドであって、
クライアントへの応答をするスレッドではありません。

Thread#thread_variable_get(key) -> object | nil (72856.0)

インスタンスメソッド

引数 key で指定した名前のスレッドローカル変数を返します。

引数 key で指定した名前のスレッドローカル変数を返します。

[注意]: Thread#[] でセットしたローカル変数(Fiber ローカル変数)と
異なり、Fiber を切り替えても同じ変数を返す事に注意してください。

例:

Thread.new {
Thread.current.thread_variable_set("foo", "bar") # スレッドローカル
Thread.current["foo"] = "bar" # Fiber ローカル

Fiber.new {
Fiber.yield ...

Thread#thread_variable_set(key, value) (72802.0)

インスタンスメソッド

引数 key で指定した名前のスレッドローカル変数に引数 value をセットします。

引数 key で指定した名前のスレッドローカル変数に引数 value をセットしま
す。

[注意]: Thread#[] でセットしたローカル変数(Fiber ローカル変数)と
異なり、セットした変数は Fiber を切り替えても共通で使える事に注意してく
ださい。

//emlist[例][ruby]{
thr = Thread.new do
Thread.current.thread_variable_set(:cat, 'meow')
Thread.current.thread_variable_set("dog", 'woof')
end
thr.join ...

Thread#thread_variable?(key) -> bool (72748.0)

インスタンスメソッド

引数 key で指定した名前のスレッドローカル変数が存在する場合に true、そうでない場合に false を返します。

引数 key で指定した名前のスレッドローカル変数が存在する場合に true、そ
うでない場合に false を返します。

@param key 変数名を String か Symbol で指定します。

me = Thread.current
me.thread_variable_set(:oliver, "a")
me.thread_variable?(:oliver) # => true
me.thread_variable?(:stanley) # => false

[注意]: Thread#[] でセットしたローカル変数(Fiber ローカル...

絞り込み条件を変える

Thread#terminate -> self (54637.0)

インスタンスメソッド

スレッドの実行を終了させます。終了時に ensure 節が実行されます。

スレッドの実行を終了させます。終了時に ensure 節が実行されます。

ただし、スレッドは終了処理中(aborting)にはなりますが、
直ちに終了するとは限りません。すでに終了している場合は何もしません。このメソッドにより
終了したスレッドの Thread#value の返り値は不定です。
自身がメインスレッドであるか最後のスレッドである場合は、プロセスを Kernel.#exit(0)
により終了します。

Kernel.#exit と違い例外 SystemExit を発生しません。

th1 = Thread.new do
begin
sleep 10
...

Etc::SC_THREAD_THREADS_MAX -> Integer (46246.0)

定数

Etc.#sysconf の引数に指定します。

Etc.#sysconf の引数に指定します。

詳細は sysconf(3) を参照してください。

Thread#backtrace_locations(range) -> [Thread::Backtrace::Location] | nil (46045.0)

インスタンスメソッド

スレッドの現在のバックトレースを Thread::Backtrace::Location の配列で返します。

スレッドの現在のバックトレースを Thread::Backtrace::Location の配
列で返します。

引数で指定した値が範囲外の場合、スレッドがすでに終了している場合は nil
を返します。

@param start 開始フレームの位置を数値で指定します。

@param length 取得するフレームの個数を指定します。

@param range 取得したいフレームの範囲を示す Range オブジェクトを指定します。

Kernel.#caller_locations と似ていますが、本メソッドは self に限定
した情報を返します。

//emlist[例][ruby]...

Thread#backtrace_locations(start = 0, length = nil) -> [Thread::Backtrace::Location] | nil (46045.0)

インスタンスメソッド

スレッドの現在のバックトレースを Thread::Backtrace::Location の配列で返します。

Thread.start(*arg) {|*arg| ... } -> Thread (45697.0)

特異メソッド

スレッドを生成して、ブロックの評価を開始します。生成したスレッドを返します。

スレッドを生成して、ブロックの評価を開始します。
生成したスレッドを返します。

基本的に Thread.new と同じですが、
new メソッドと違い initialize メソッドを呼びません。

@param arg 引数 arg はそのままブロックに渡されます。スレッドの開始と同時にその
スレッド固有のローカル変数に値を渡すために使用します。

@raise ThreadError 現在のスレッドが属する ThreadGroup が freeze されている場合に発生します。またブロックを与えられずに呼ばれた場合にも発生します。

注意:

例えば、以下のコー...

絞り込み条件を変える

Thread.list -> [Thread] (45676.0)

特異メソッド

全ての生きているスレッドを含む配列を生成して返します。aborting 状態であるスレッドも要素に含まれます。

全ての生きているスレッドを含む配列を生成して返します。aborting 状態であるスレッド
も要素に含まれます。

Thread.new do
sleep
end
sleep 0.1

p Thread.list #=> [#<Thread:0x40377a54 sleep>, #<Thread:0x4022e6fc run>]

Thread.current -> Thread (45640.0)

特異メソッド

現在実行中のスレッド(カレントスレッド)を返します。

現在実行中のスレッド(カレントスレッド)を返します。

p Thread.current #=> #<Thread:0x4022e6fc run>

Thread#backtrace -> [String] | nil (45637.0)

インスタンスメソッド

スレッドの現在のバックトレースを返します。

スレッドの現在のバックトレースを返します。

スレッドがすでに終了している場合は nil を返します。

//emlist[例][ruby]{
class C1
def m1
sleep 5
end
def m2
m1
end
end

th = Thread.new {C1.new.m2; Thread.stop}
th.backtrace
# => [
# [0] "(irb):3:in `sleep'",
# [1] "(irb):3:in `m1'",
# [2] "(irb):6:in `m2'",
# [3] ...

Thread.handle_interrupt(hash) { ... } -> object (45571.0)

特異メソッド

スレッドの割り込みのタイミングを引数で指定した内容に変更してブロックを実行します。

スレッドの割り込みのタイミングを引数で指定した内容に変更してブロックを
実行します。

「割り込み」とは、非同期イベントや Thread#raise や
Thread#kill、Signal.#trap(未サポート)、メインスレッドの終了
(メインスレッドが終了すると、他のスレッドも終了されます)を意味します。

@param hash 例外クラスがキー、割り込みのタイミングを指定する
Symbol が値の Hash を指定します。
値の内容は以下のいずれかです。

: :immediate

すぐに割り込みます。

: :on_block...

Thread.pending_interrupt?(error = nil) -> bool (45535.0)

特異メソッド

非同期割り込みのキューが空かどうかを返します。

非同期割り込みのキューが空かどうかを返します。

Thread.handle_interrupt は非同期割り込みの発生を延期させるのに使
用しますが、本メソッドは任意の非同期割り込みが存在するかどうかを確認す
るのに使用します。

本メソッドが true を返した場合、Thread.handle_interrupt で例外の
発生を延期するブロックを終了すると延期させられていた例外を発生させるこ
とができます。

@param error 対象の例外クラスを指定します。省略した場合は全ての例外を対
象に確認を行います。

例: 延期させられていた例外をただちに発生...

絞り込み条件を変える

Thread#status -> String | false | nil (45499.0)

インスタンスメソッド

生きているスレッドの状態を文字列 "run"、"sleep", "aborting" のいずれかで返します。正常終了したスレッドに対して false、例外により終了したスレッドに対して nil を返します。

生きているスレッドの状態を文字列 "run"、"sleep", "aborting" のいず
れかで返します。正常終了したスレッドに対して false、例外によ
り終了したスレッドに対して nil を返します。

Thread#alive? が真を返すなら、このメソッドも真です。

例:
a = Thread.new { raise("die now") }
b = Thread.new { Thread.stop }
c = Thread.new { Thread.exit }
d = Thread.new { sleep }
d.kill ...

Thread#report_on_exception -> bool (45463.0)

インスタンスメソッド

真の場合、そのスレッドが例外によって終了した時に、その内容を $stderr に報告します。

真の場合、そのスレッドが例外によって終了した時に、その内容を $stderr に報告します。

デフォルトはスレッド作成時の Thread.report_on_exception です。

@param newstate スレッド実行中に例外発生した場合、その内容を報告するかどうかを true か false で指定します。

//emlist[例][ruby]{
a = Thread.new{ Thread.stop; raise }
a.report_on_exception = true
a.report_on_exception # => true
a.run
# => #<Th...

Thread#report_on_exception=(newstate) (45463.0)

インスタンスメソッド

真の場合、そのスレッドが例外によって終了した時に、その内容を $stderr に報告します。

Thread#abort_on_exception -> bool (45457.0)

インスタンスメソッド

真の場合、そのスレッドが例外によって終了した時に、インタプリタ全体を中断させます。false の場合、あるスレッドで起こった例外は、Thread#join などで検出されない限りそのスレッドだけをなにも警告を出さずに終了させます。

真の場合、そのスレッドが例外によって終了した時に、インタプリタ
全体を中断させます。false の場合、あるスレッドで起こった例
外は、Thread#join などで検出されない限りそのスレッ
ドだけをなにも警告を出さずに終了させます。

デフォルトは偽です。c:Thread#exceptionを参照してください。

@param newstate 自身を実行中に例外発生した場合、インタプリタ全体を終了させるかどうかを true か false で指定します。

//emlist[例][ruby]{
thread = Thread.new { sleep 1 }
thread.abort_o...

Thread#abort_on_exception=(newstate) (45457.0)

インスタンスメソッド

絞り込み条件を変える

Thread.abort_on_exception -> bool (45421.0)

特異メソッド

真の時は、いずれかのスレッドが例外によって終了した時に、インタプリタ全体を中断させます。false の場合、あるスレッドで起こった例外は、Thread#join などで検出されない限りそのスレッドだけをなにも警告を出さずに終了させます。

真の時は、いずれかのスレッドが例外によって終了した時に、インタプリタ
全体を中断させます。false の場合、あるスレッドで起こった例外は、Thread#join
などで検出されない限りそのスレッドだけをなにも警告を出さずに終了させます。

デフォルトは false です。

c:Thread#exceptionを参照してください。

@param newstate スレッド実行中に例外発生した場合、インタプリタ全体を終了させるかどうかを true か false で指定します。

//emlist[例][ruby]{
Thread.abort_on_exception # => false...

Thread.abort_on_exception=(newstate) (45421.0)

特異メソッド

Thread.stop -> nil (45421.0)

特異メソッド

他のスレッドから Thread#run メソッドで再起動されるまで、カレントスレッドの実行を停止します。

他のスレッドから Thread#run メソッドで再起動されるまで、カレ
ントスレッドの実行を停止します。

//emlist[例][ruby]{
a = Thread.new { print "a"; Thread.stop; print "c" }
sleep 0.1 while a.status!='sleep'
print "b"
a.run
a.join
# => "abc"
//}

@see Thread#run, Thread#wakeup

Thread#set_trace_func(pr) -> Proc | nil (45409.0)

インスタンスメソッド

スレッドにトレース用ハンドラを設定します。

スレッドにトレース用ハンドラを設定します。

nil を渡すとトレースを解除します。

設定したハンドラを返します。

//emlist[例][ruby]{
th = Thread.new do
class Trace
end
2.to_s
Thread.current.set_trace_func nil
3.to_s
end
th.set_trace_func lambda {|*arg| p arg }
th.join

# => ["line", "example.rb", 2, nil, #<Binding:0x00007fc8de87cb08>, nil]
#...

Thread.report_on_exception -> bool (45409.0)

特異メソッド

真の時は、いずれかのスレッドが例外によって終了した時に、その内容を $stderr に報告します。

真の時は、いずれかのスレッドが例外によって終了した時に、その内容を $stderr に報告します。

デフォルトは true です。

Thread.new { 1.times { raise } }

は $stderr に以下のように出力します:

#<Thread:...> terminated with exception (report_on_exception is true):
Traceback (most recent call last):
2: from -e:1:in `block in <main>'
1: fro...

絞り込み条件を変える

Thread.report_on_exception=(newstate) (45409.0)

特異メソッド

真の時は、いずれかのスレッドが例外によって終了した時に、その内容を $stderr に報告します。

Thread#fetch(name, default = nil) {|name| ... } -> object (45391.0)

インスタンスメソッド

name に関連づけられたスレッドに固有のデータを返します。 name に対応するスレッド固有データがない時には、引数 default が与えられていればその値を、ブロックが与えられていればそのブロックを評価した値を返します。

name に関連づけられたスレッドに固有のデータを返します。
name に対応するスレッド固有データがない時には、引数 default が
与えられていればその値を、ブロックが与えられていれば
そのブロックを評価した値を返します。

@param name スレッド固有データのキーを文字列か Symbol で指定します。
@param default name に対応するスレッド固有データがない時の返り値を指定します。
@raise KeyError 引数defaultもブロックも与えられてない時、
name に対応するスレッド固有データがないと発生します。
...

Thread#stop? -> bool (45391.0)

インスタンスメソッド

スレッドが終了(dead)あるいは停止(stop)している時、true を返します。

スレッドが終了(dead)あるいは停止(stop)している時、true を返します。

//emlist[例][ruby]{
a = Thread.new { Thread.stop }
b = Thread.current
a.stop? # => true
b.stop? # => false
//}

@see Thread#alive?, Thread#status

Thread#inspect -> String (45373.0)

インスタンスメソッド

自身を人間が読める形式に変換した文字列を返します。

自身を人間が読める形式に変換した文字列を返します。

//emlist[例][ruby]{
a = Thread.current
a.inspect # => "#<Thread:0x00007fdbaf07ddb0 run>"
b = Thread.new{}
b.inspect # => "#<Thread:0x00007fdbaf8f7d10@(irb):3 dead>"
//}

Thread#to_s -> String (45373.0)

インスタンスメソッド

自身を人間が読める形式に変換した文字列を返します。

絞り込み条件を変える

Thread#priority -> Integer (45355.0)

インスタンスメソッド

スレッドの優先度を返します。この値が大きいほど優先度が高くなります。メインスレッドのデフォルト値は 0 です。新しく生成されたスレッドは親スレッドの priority を引き継ぎます。

スレッドの優先度を返します。この値が大きいほど優先度が高くなります。
メインスレッドのデフォルト値は 0 です。新しく生成されたスレッドは親スレッドの
priority を引き継ぎます。

@param val スレッドの優先度を指定します。プラットフォームに依存します。

//emlist[例][ruby]{
Thread.current.priority # => 0

count1 = count2 = 0
a = Thread.new do
loop { count1 += 1 }
end
a.priority = -1

b = Thread.new do
...

Thread#priority=(val) (45355.0)

インスタンスメソッド

Thread.exit -> () (45349.0)

特異メソッド

カレントスレッドに対して Thread#exit を呼びます。

Thread#add_trace_func(pr) -> Proc (45337.0)

インスタンスメソッド

スレッドにトレース用ハンドラを追加します。

スレッドにトレース用ハンドラを追加します。

追加したハンドラを返します。

@param pr トレースハンドラ(Proc オブジェクト)

//emlist[例][ruby]{
th = Thread.new do
class Trace
end
43.to_s
end
th.add_trace_func lambda {|*arg| p arg }
th.join

# => ["line", "example.rb", 4, nil, #<Binding:0x00007f98e107d0d8>, nil]
# => ["c-call", "example.rb", 4, ...

Thread#exit -> self (45337.0)

インスタンスメソッド

スレッドの実行を終了させます。終了時に ensure 節が実行されます。

絞り込み条件を変える

Thread#pending_interrupt?(error = nil) -> bool (45319.0)

インスタンスメソッド

self の非同期例外のキューが空かどうかを返します。

self の非同期例外のキューが空かどうかを返します。

@param error 対象の例外クラスを指定します。

@see Thread.pending_interrupt?

Net::IMAP#uid_thread(algorithm, search_keys, charset) -> [Net::IMAP::ThreadMember] (37588.0)

インスタンスメソッド

THREADコマンドを送り、メールボックスを検索した結果をスレッド形式の木構造で返します。

THREADコマンドを送り、メールボックスを検索した結果を
スレッド形式の木構造で返します。

ほぼ Net::IMAP#thread と同じですが、返ってくるオブジェクトの
Net::IMAP::ThreadMember#seqno の内容が message sequence number
ではなく UID となります。

@param algorithm スレッド構造構築アルゴリズム名(文字列)
@param search_key 検索条件(文字列配列)
@param charset 検索条件の解釈に用いるCHARSET名(文字列)
@see Net::IMAP::ThreadMember...

Thread.kill(thread) -> Thread (37393.0)

特異メソッド

指定したスレッド thread に対して Thread#exit を呼びます。終了したスレッドを返します。

指定したスレッド thread に対して Thread#exit を呼びます。終了したスレッドを返します。

@param thread 終了したい Thread オブジェクトを指定します。

th = Thread.new do
end

p Thread.kill(th) #=> #<Thread:0x40221bc8 dead>

VALUE rb_thread_run(VALUE thread) (37249.0)

関数

スレッド thread に実行権を渡します。

VALUE rb_thread_wakeup(VALUE thread) (37249.0)

関数

停止中のスレッド thread を再開させます。

絞り込み条件を変える

VALUE rb_thread_local_aref(VALUE thread, ID id) (37201.0)

関数

VALUE rb_thread_local_aset(VALUE thread, ID id, VALUE val) (37201.0)

関数

static VALUE rb_thread_start_0(VALUE (*fn)(), void *arg, rb_thread_t th_arg) (37201.0)

関数

static VALUE rb_thread_status(VALUE thread) (37201.0)

関数

static rb_thread_t rb_thread_check(VALUE data) (37201.0)

関数

絞り込み条件を変える

Net::IMAP#client_thread -> Thread (36907.0)

インスタンスメソッド

このメソッドは obsolete です。使わないでください。

int rb_thread_fd_writable(int fd) (36901.0)

関数

static VALUE rb_thread_abort_exc(VALUE thread) (36901.0)

関数

static VALUE rb_thread_abort_exc_set(VALUE thread, VALUE val) (36901.0)

関数

static VALUE rb_thread_alive_p(VALUE thread) (36901.0)

関数

絞り込み条件を変える

static VALUE rb_thread_aref(VALUE thread, VALUE id) (36901.0)

関数

static VALUE rb_thread_aset(VALUE thread, VALUE id, VALUE val) (36901.0)

関数

static VALUE rb_thread_initialize(VALUE thread, VALUE args) (36901.0)

関数

static VALUE rb_thread_inspect(VALUE thread) (36901.0)

関数

static VALUE rb_thread_join_m(int argc, VALUE *argv, VALUE thread) (36901.0)

関数

絞り込み条件を変える

static VALUE rb_thread_key_p(VALUE thread, VALUE id) (36901.0)

関数

static VALUE rb_thread_keys(VALUE thread) (36901.0)

関数

static VALUE rb_thread_kill(VALUE thread) (36901.0)

関数

static VALUE rb_thread_priority(VALUE thread) (36901.0)

関数

static VALUE rb_thread_priority_set(VALUE thread, VALUE prio) (36901.0)

関数

絞り込み条件を変える

static VALUE rb_thread_raise(int argc, VALUE *argv, rb_thread_t th) (36901.0)

関数

static VALUE rb_thread_raise_m(int argc, VALUE *argv, VALUE thread) (36901.0)

関数

static VALUE rb_thread_safe_level(VALUE thread) (36901.0)

関数

static VALUE rb_thread_start(VALUE klass, VALUE args) (36901.0)

関数

static VALUE rb_thread_stop_p(VALUE thread) (36901.0)

関数

絞り込み条件を変える

static VALUE rb_thread_value(VALUE thread) (36901.0)

関数

static VALUE rb_thread_yield(VALUE arg, rb_thread_t th) (36901.0)

関数

static int rb_thread_dead(rb_thread_t th) (36901.0)

関数

static int rb_thread_join(rb_thread_t th, double limit) (36901.0)

関数

static rb_thread_t rb_thread_alloc(VALUE klass) (36901.0)

関数

絞り込み条件を変える

static void rb_thread_ready(rb_thread_t th) (36901.0)

関数

static void rb_thread_remove(rb_thread_t th) (36901.0)

関数

static void rb_thread_restore_context(rb_thread_t th, int exit) (36901.0)

関数

スレッドを切り替えるにあたって、切り替え先のスレッド th のコンテキストを評価器に復帰します。

スレッドを切り替えるにあたって、切り替え先のスレッド th の
コンテキストを評価器に復帰します。

static void rb_thread_save_context(rb_thread_t th) (36901.0)

関数

スレッドを切り替えるにあたって、現在実行中のスレッド th のコンテキストを評価器から th に退避します。

スレッドを切り替えるにあたって、現在実行中のスレッド th の
コンテキストを評価器から th に退避します。

Thread#[](name) -> object | nil (36697.0)

インスタンスメソッド

name に対応したスレッドに固有のデータを取り出します。 name に対応するスレッド固有データがなければ nil を返します。

name に対応したスレッドに固有のデータを取り出します。
name に対応するスレッド固有データがなければ nil を返し
ます。

@param name スレッド固有データのキーを文字列か Symbol で指定します。

//emlist[例][ruby]{
[
Thread.new { Thread.current["name"] = "A" },
Thread.new { Thread.current[:name] = "B" },
Thread.new { Thread.current["name"] = "C" }
].each do |th|
th.join...

絞り込み条件を変える

Thread.fork(*arg) {|*arg| ... } -> Thread (36697.0)

特異メソッド

スレッドを生成して、ブロックの評価を開始します。生成したスレッドを返します。

Thread.new(*arg) {|*arg| ... } -> Thread (36676.0)

特異メソッド

スレッドを生成して、ブロックの評価を開始します。生成したスレッドを返します。

スレッドを生成して、ブロックの評価を開始します。
生成したスレッドを返します。

@param arg 引数 arg はそのままブロックに渡されます。スレッドの開始と同時にその
スレッド固有のローカル変数に値を渡すために使用します。

@raise ThreadError 現在のスレッドが属する ThreadGroup が freeze されている場合に発生します。またブロックを与えられずに呼ばれた場合にも発生します。

注意:

例えば、以下のコードは間違いです。スレッドの実行が開始される前に
変数 i が書き変わる可能性があるからです。

for i in 1....

VALUE rb_thread_stop(void) (36649.0)