非常教程

Ruby 2.4参考手册

时间耗尽 | Timeout

Timeout

超时长时间运行的块

概要

require 'timeout'
status = Timeout::timeout(5) {
  # Something that should be interrupted if it takes more than 5 seconds...
}

描述

超时提供了一种自动终止可能长时间运行的操作的方法,如果它没有在一段固定的时间内完成。

以前的版本没有使用名称空间模块,但是为了向后兼容提供超时。您应该更喜欢#timeout。

版权

公共类方法

超时(sec,klass = nil,message = nil){| sec | ...}显示源文件

在块中执行操作,如果sec完成时间超过了几秒,则会发生错误。

sec

等待块终止的秒数。任何数字都可以使用,包括Floats指定小数秒。值为0或nil将在没有任何超时的情况下执行该块。

klass

如果该块未能在sec数秒内终止,则引发异常类。省略将使用默认的Timeout :: Error

message

用Exception Class引发错误消息。省略将使用默认的“执行过期”

如果块在sec秒之前完成,则返回块的结果,否则基于值的值抛出异常klass

除非klass明确给出,否则抛出的用于终止给定块的异常无法在块内获救。

请注意,这是模块Timeout的一种方法,所以你可以include Timeout进入你的类,所以它们有一个超时方法和一个模块方法,所以你可以直接调用它作为#timeout。

# File lib/timeout.rb, line 74
def timeout(sec, klass = nil, message = nil)   #:yield: +sec+
  return yield(sec) if sec == nil or sec.zero?
  message ||= "execution expired".freeze
  from = "from #{caller_locations(1, 1)[0]}" if $DEBUG
  e = Error
  bl = proc do |exception|
    begin
      x = Thread.current
      y = Thread.start {
        Thread.current.name = from
        begin
          sleep sec
        rescue => e
          x.raise e
        else
          x.raise exception, message
        end
      }
      return yield(sec)
    ensure
      if y
        y.kill
        y.join # make sure y is dead.
      end
    end
  end
  if klass
    begin
      bl.call(klass)
    rescue klass => e
      bt = e.backtrace
    end
  else
    bt = Error.catch(message, &bl)
  end
  level = -caller(CALLER_OFFSET).size-2
  while THIS_FILE =~ bt[level]
    bt.delete_at(level)
  end
  raise(e, message, bt)
end

私有实例方法

超时(sec,klass = nil,message = nil){| sec | ...}显示源文件

在块中执行操作,如果sec完成时间超过了几秒,则会发生错误。

等待块终止的秒数。任何数字都可以使用,包括Floats指定小数秒。值为0或nil将在没有任何超时的情况下执行该块。

如果该块未能在sec数秒内终止,则引发异常类。省略将使用默认的Timeout :: Error

信息

用Exception Class引发错误消息。省略将使用默认的“执行过期”

如果块在sec秒之前完成,则返回块的结果,否则基于值的值抛出异常klass

除非klass明确给出,否则抛出的用于终止给定块的异常无法在块内获救。

请注意,这是模块Timeout的一种方法,所以你可以include Timeout进入你的类,所以它们有一个超时方法和一个模块方法,所以你可以直接调用它作为#timeout。

# File lib/timeout.rb, line 74
def timeout(sec, klass = nil, message = nil)   #:yield: +sec+
  return yield(sec) if sec == nil or sec.zero?
  message ||= "execution expired".freeze
  from = "from #{caller_locations(1, 1)[0]}" if $DEBUG
  e = Error
  bl = proc do |exception|
    begin
      x = Thread.current
      y = Thread.start {
        Thread.current.name = from
        begin
          sleep sec
        rescue => e
          x.raise e
        else
          x.raise exception, message
        end
      }
      return yield(sec)
    ensure
      if y
        y.kill
        y.join # make sure y is dead.
      end
    end
  end
  if klass
    begin
      bl.call(klass)
    rescue klass => e
      bt = e.backtrace
    end
  else
    bt = Error.catch(message, &bl)
  end
  level = -caller(CALLER_OFFSET).size-2
  while THIS_FILE =~ bt[level]
    bt.delete_at(level)
  end
  raise(e, message, bt)
end

时间耗尽 | Timeout相关

Ruby 2.4

Ruby 是一种面向对象、命令式、函数式、动态的通用编程语言,是世界上最优美而巧妙的语言。

主页 https://www.ruby-lang.org/
源码 https://github.com/ruby/ruby
版本 2.4
发布版本 2.4.1

Ruby 2.4目录

1.缩略 | Abbrev
2.ARGF
3.数组 | Array
4.Base64
5.基本对象 | BasicObject
6.基准测试 | Benchmark
7.BigDecimal
8.绑定 | Binding
9.CGI
10.类 | Class
11.比较 | Comparable
12.负责 | Complex
13.计算续体 | Continuation
14.覆盖 | Coverage
15.CSV
16.日期 | Date
17.日期时间 | DateTime
18.DBM
19.代理 | Delegator
20.摘要 | Digest
21.Dir
22.DRb
23.编码 | Encoding
24.枚举 | Enumerable
25.枚举 | Enumerator
26.ENV
27.ERB
28.错误 | Errors
29.Etc
30.期望值 | Exception
31.错误类 | FalseClass
32.Fiber
33.Fiddle
34.文件 | File
35.文件实用程序 | FileUtils
36.查找 | Find
37.浮点 | Float
38.Forwardable
39.GC
40.GDBM
41.GetoptLong
42.Hash
43.Integer
44.IO
45.IPAddr
46.JSON
47.Kernel
48.语言 | 3Language
49.记录 | Logger
50.编排 | Marshal
51.MatchData
52.数学 | Math
53.矩阵 | Matrix
54.方法 | Method
55.模型 | Module
56.监控 | Monitor
57. 互斥 | Mutex
58.Net
59.Net::FTP
60.Net::HTTP
61.Net::IMAP
62.Net::SMTP
63.NilClass
64.数字 | Numeric
65.对象 | Object
66.ObjectSpace
67.Observable
68.Open3
69.OpenSSL
70.OpenStruct
71.OpenURI
72.OptionParser
73.路径名 | Pathname
74.完整输出 | PrettyPrint
75.Prime
76.Proc
77.过程 | Process
78.PStore
79.PTY
80.队列 | Queue
81.随机 | Random
82.范围 | Range
83.合理的 | Rational
84.Readline
85.Regexp
86.Resolv
87.Ripper
88.RubyVM
89.Scanf
90.SDBM
91.SecureRandom
92.Set
93.Shell
94.信号 | Signal
95.Singleton
96.套接字 | Socket
97.字符串 | String
98.StringIO
99.StringScanner
100.结构 | Struct