#--

[0] Fix | Delete

# benchmark.rb - a performance benchmarking library

[1] Fix | Delete

#

[2] Fix | Delete

# $Id: benchmark.rb 47526 2014-09-11 08:09:07Z normal $

[3] Fix | Delete

#

[4] Fix | Delete

# Created by Gotoken (gotoken@notwork.org).

[5] Fix | Delete

#

[6] Fix | Delete

# Documentation by Gotoken (original RD), Lyle Johnson (RDoc conversion), and

[7] Fix | Delete

# Gavin Sinclair (editing).

[8] Fix | Delete

#++

[9] Fix | Delete

#

[10] Fix | Delete

# == Overview

[11] Fix | Delete

#

[12] Fix | Delete

# The Benchmark module provides methods for benchmarking Ruby code, giving

[13] Fix | Delete

# detailed reports on the time taken for each task.

[14] Fix | Delete

#

[15] Fix | Delete

[16] Fix | Delete

# The Benchmark module provides methods to measure and report the time

[17] Fix | Delete

# used to execute Ruby code.

[18] Fix | Delete

#

[19] Fix | Delete

# * Measure the time to construct the string given by the expression

[20] Fix | Delete

# <code>"a"*1_000_000_000</code>:

[21] Fix | Delete

#

[22] Fix | Delete

# require 'benchmark'

[23] Fix | Delete

#

[24] Fix | Delete

# puts Benchmark.measure { "a"*1_000_000_000 }

[25] Fix | Delete

#

[26] Fix | Delete

# On my machine (OSX 10.8.3 on i5 1.7 Ghz) this generates:

[27] Fix | Delete

#

[28] Fix | Delete

# 0.350000 0.400000 0.750000 ( 0.835234)

[29] Fix | Delete

#

[30] Fix | Delete

# This report shows the user CPU time, system CPU time, the sum of

[31] Fix | Delete

# the user and system CPU times, and the elapsed real time. The unit

[32] Fix | Delete

# of time is seconds.

[33] Fix | Delete

#

[34] Fix | Delete

# * Do some experiments sequentially using the #bm method:

[35] Fix | Delete

#

[36] Fix | Delete

# require 'benchmark'

[37] Fix | Delete

#

[38] Fix | Delete

# n = 5000000

[39] Fix | Delete

# Benchmark.bm do |x|

[40] Fix | Delete

# x.report { for i in 1..n; a = "1"; end }

[41] Fix | Delete

# x.report { n.times do ; a = "1"; end }

[42] Fix | Delete

# x.report { 1.upto(n) do ; a = "1"; end }

[43] Fix | Delete

# end

[44] Fix | Delete

#

[45] Fix | Delete

# The result:

[46] Fix | Delete

#

[47] Fix | Delete

# user system total real

[48] Fix | Delete

# 1.010000 0.000000 1.010000 ( 1.014479)

[49] Fix | Delete

# 1.000000 0.000000 1.000000 ( 0.998261)

[50] Fix | Delete

# 0.980000 0.000000 0.980000 ( 0.981335)

[51] Fix | Delete

#

[52] Fix | Delete

# * Continuing the previous example, put a label in each report:

[53] Fix | Delete

#

[54] Fix | Delete

# require 'benchmark'

[55] Fix | Delete

#

[56] Fix | Delete

# n = 5000000

[57] Fix | Delete

# Benchmark.bm(7) do |x|

[58] Fix | Delete

# x.report("for:") { for i in 1..n; a = "1"; end }

[59] Fix | Delete

# x.report("times:") { n.times do ; a = "1"; end }

[60] Fix | Delete

# x.report("upto:") { 1.upto(n) do ; a = "1"; end }

[61] Fix | Delete

# end

[62] Fix | Delete

#

[63] Fix | Delete

# The result:

[64] Fix | Delete

#

[65] Fix | Delete

# user system total real

[66] Fix | Delete

# for: 1.010000 0.000000 1.010000 ( 1.015688)

[67] Fix | Delete

# times: 1.000000 0.000000 1.000000 ( 1.003611)

[68] Fix | Delete

# upto: 1.030000 0.000000 1.030000 ( 1.028098)

[69] Fix | Delete

#

[70] Fix | Delete

# * The times for some benchmarks depend on the order in which items

[71] Fix | Delete

# are run. These differences are due to the cost of memory

[72] Fix | Delete

# allocation and garbage collection. To avoid these discrepancies,

[73] Fix | Delete

# the #bmbm method is provided. For example, to compare ways to

[74] Fix | Delete

# sort an array of floats:

[75] Fix | Delete

#

[76] Fix | Delete

# require 'benchmark'

[77] Fix | Delete

#

[78] Fix | Delete

# array = (1..1000000).map { rand }

[79] Fix | Delete

#

[80] Fix | Delete

# Benchmark.bmbm do |x|

[81] Fix | Delete

# x.report("sort!") { array.dup.sort! }

[82] Fix | Delete

# x.report("sort") { array.dup.sort }

[83] Fix | Delete

# end

[84] Fix | Delete

#

[85] Fix | Delete

# The result:

[86] Fix | Delete

#

[87] Fix | Delete

# Rehearsal -----------------------------------------

[88] Fix | Delete

# sort! 1.490000 0.010000 1.500000 ( 1.490520)

[89] Fix | Delete

# sort 1.460000 0.000000 1.460000 ( 1.463025)

[90] Fix | Delete

# -------------------------------- total: 2.960000sec

[91] Fix | Delete

#

[92] Fix | Delete

# user system total real

[93] Fix | Delete

# sort! 1.460000 0.000000 1.460000 ( 1.460465)

[94] Fix | Delete

# sort 1.450000 0.010000 1.460000 ( 1.448327)

[95] Fix | Delete

#

[96] Fix | Delete

# * Report statistics of sequential experiments with unique labels,

[97] Fix | Delete

# using the #benchmark method:

[98] Fix | Delete

#

[99] Fix | Delete

# require 'benchmark'

[100] Fix | Delete

# include Benchmark # we need the CAPTION and FORMAT constants

[101] Fix | Delete

#

[102] Fix | Delete

# n = 5000000

[103] Fix | Delete

# Benchmark.benchmark(CAPTION, 7, FORMAT, ">total:", ">avg:") do |x|

[104] Fix | Delete

# tf = x.report("for:") { for i in 1..n; a = "1"; end }

[105] Fix | Delete

# tt = x.report("times:") { n.times do ; a = "1"; end }

[106] Fix | Delete

# tu = x.report("upto:") { 1.upto(n) do ; a = "1"; end }

[107] Fix | Delete

# [tf+tt+tu, (tf+tt+tu)/3]

[108] Fix | Delete

# end

[109] Fix | Delete

#

[110] Fix | Delete

# The result:

[111] Fix | Delete

#

[112] Fix | Delete

# user system total real

[113] Fix | Delete

# for: 0.950000 0.000000 0.950000 ( 0.952039)

[114] Fix | Delete

# times: 0.980000 0.000000 0.980000 ( 0.984938)

[115] Fix | Delete

# upto: 0.950000 0.000000 0.950000 ( 0.946787)

[116] Fix | Delete

# >total: 2.880000 0.000000 2.880000 ( 2.883764)

[117] Fix | Delete

# >avg: 0.960000 0.000000 0.960000 ( 0.961255)

[118] Fix | Delete

[119] Fix | Delete

module Benchmark

[120] Fix | Delete

[121] Fix | Delete

BENCHMARK_VERSION = "2002-04-25" # :nodoc:

[122] Fix | Delete

[123] Fix | Delete

# Invokes the block with a Benchmark::Report object, which

[124] Fix | Delete

# may be used to collect and report on the results of individual

[125] Fix | Delete

# benchmark tests. Reserves +label_width+ leading spaces for

[126] Fix | Delete

# labels on each line. Prints +caption+ at the top of the

[127] Fix | Delete

# report, and uses +format+ to format each line.

[128] Fix | Delete

# Returns an array of Benchmark::Tms objects.

[129] Fix | Delete

#

[130] Fix | Delete

# If the block returns an array of

[131] Fix | Delete

# Benchmark::Tms objects, these will be used to format

[132] Fix | Delete

# additional lines of output. If +label+ parameters are

[133] Fix | Delete

# given, these are used to label these extra lines.

[134] Fix | Delete

#

[135] Fix | Delete

# _Note_: Other methods provide a simpler interface to this one, and are

[136] Fix | Delete

# suitable for nearly all benchmarking requirements. See the examples in

[137] Fix | Delete

# Benchmark, and the #bm and #bmbm methods.

[138] Fix | Delete

#

[139] Fix | Delete

# Example:

[140] Fix | Delete

#

[141] Fix | Delete

# require 'benchmark'

[142] Fix | Delete

# include Benchmark # we need the CAPTION and FORMAT constants

[143] Fix | Delete

#

[144] Fix | Delete

# n = 5000000

[145] Fix | Delete

# Benchmark.benchmark(CAPTION, 7, FORMAT, ">total:", ">avg:") do |x|

[146] Fix | Delete

# tf = x.report("for:") { for i in 1..n; a = "1"; end }

[147] Fix | Delete

# tt = x.report("times:") { n.times do ; a = "1"; end }

[148] Fix | Delete

# tu = x.report("upto:") { 1.upto(n) do ; a = "1"; end }

[149] Fix | Delete

# [tf+tt+tu, (tf+tt+tu)/3]

[150] Fix | Delete

# end

[151] Fix | Delete

#

[152] Fix | Delete

# Generates:

[153] Fix | Delete

#

[154] Fix | Delete

# user system total real

[155] Fix | Delete

# for: 0.970000 0.000000 0.970000 ( 0.970493)

[156] Fix | Delete

# times: 0.990000 0.000000 0.990000 ( 0.989542)

[157] Fix | Delete

# upto: 0.970000 0.000000 0.970000 ( 0.972854)

[158] Fix | Delete

# >total: 2.930000 0.000000 2.930000 ( 2.932889)

[159] Fix | Delete

# >avg: 0.976667 0.000000 0.976667 ( 0.977630)

[160] Fix | Delete

#

[161] Fix | Delete

[162] Fix | Delete

def benchmark(caption = "", label_width = nil, format = nil, *labels) # :yield: report

[163] Fix | Delete

sync = STDOUT.sync

[164] Fix | Delete

STDOUT.sync = true

[165] Fix | Delete

label_width ||= 0

[166] Fix | Delete

label_width += 1

[167] Fix | Delete

format ||= FORMAT

[168] Fix | Delete

print ' '*label_width + caption unless caption.empty?

[169] Fix | Delete

report = Report.new(label_width, format)

[170] Fix | Delete

results = yield(report)

[171] Fix | Delete

Array === results and results.grep(Tms).each {|t|

[172] Fix | Delete

print((labels.shift || t.label || "").ljust(label_width), t.format(format))

[173] Fix | Delete

}

[174] Fix | Delete

report.list

[175] Fix | Delete

ensure

[176] Fix | Delete

STDOUT.sync = sync unless sync.nil?

[177] Fix | Delete

end

[178] Fix | Delete

[179] Fix | Delete

[180] Fix | Delete

# A simple interface to the #benchmark method, #bm generates sequential

[181] Fix | Delete

# reports with labels. The parameters have the same meaning as for

[182] Fix | Delete

# #benchmark.

[183] Fix | Delete

#

[184] Fix | Delete

# require 'benchmark'

[185] Fix | Delete

#

[186] Fix | Delete

# n = 5000000

[187] Fix | Delete

# Benchmark.bm(7) do |x|

[188] Fix | Delete

# x.report("for:") { for i in 1..n; a = "1"; end }

[189] Fix | Delete

# x.report("times:") { n.times do ; a = "1"; end }

[190] Fix | Delete

# x.report("upto:") { 1.upto(n) do ; a = "1"; end }

[191] Fix | Delete

# end

[192] Fix | Delete

#

[193] Fix | Delete

# Generates:

[194] Fix | Delete

#

[195] Fix | Delete

# user system total real

[196] Fix | Delete

# for: 0.960000 0.000000 0.960000 ( 0.957966)

[197] Fix | Delete

# times: 0.960000 0.000000 0.960000 ( 0.960423)

[198] Fix | Delete

# upto: 0.950000 0.000000 0.950000 ( 0.954864)

[199] Fix | Delete

#

[200] Fix | Delete

[201] Fix | Delete

def bm(label_width = 0, *labels, &blk) # :yield: report

[202] Fix | Delete

benchmark(CAPTION, label_width, FORMAT, *labels, &blk)

[203] Fix | Delete

end

[204] Fix | Delete

[205] Fix | Delete

[206] Fix | Delete

# Sometimes benchmark results are skewed because code executed

[207] Fix | Delete

# earlier encounters different garbage collection overheads than

[208] Fix | Delete

# that run later. #bmbm attempts to minimize this effect by running

[209] Fix | Delete

# the tests twice, the first time as a rehearsal in order to get the

[210] Fix | Delete

# runtime environment stable, the second time for

[211] Fix | Delete

# real. GC.start is executed before the start of each of

[212] Fix | Delete

# the real timings; the cost of this is not included in the

[213] Fix | Delete

# timings. In reality, though, there's only so much that #bmbm can

[214] Fix | Delete

# do, and the results are not guaranteed to be isolated from garbage

[215] Fix | Delete

# collection and other effects.

[216] Fix | Delete

#

[217] Fix | Delete

# Because #bmbm takes two passes through the tests, it can

[218] Fix | Delete

# calculate the required label width.

[219] Fix | Delete

#

[220] Fix | Delete

# require 'benchmark'

[221] Fix | Delete

#

[222] Fix | Delete

# array = (1..1000000).map { rand }

[223] Fix | Delete

#

[224] Fix | Delete

# Benchmark.bmbm do |x|

[225] Fix | Delete

# x.report("sort!") { array.dup.sort! }

[226] Fix | Delete

# x.report("sort") { array.dup.sort }

[227] Fix | Delete

# end

[228] Fix | Delete

#

[229] Fix | Delete

# Generates:

[230] Fix | Delete

#

[231] Fix | Delete

# Rehearsal -----------------------------------------

[232] Fix | Delete

# sort! 1.440000 0.010000 1.450000 ( 1.446833)

[233] Fix | Delete

# sort 1.440000 0.000000 1.440000 ( 1.448257)

[234] Fix | Delete

# -------------------------------- total: 2.890000sec

[235] Fix | Delete

#

[236] Fix | Delete

# user system total real

[237] Fix | Delete

# sort! 1.460000 0.000000 1.460000 ( 1.458065)

[238] Fix | Delete

# sort 1.450000 0.000000 1.450000 ( 1.455963)

[239] Fix | Delete

#

[240] Fix | Delete

# #bmbm yields a Benchmark::Job object and returns an array of

[241] Fix | Delete

# Benchmark::Tms objects.

[242] Fix | Delete

#

[243] Fix | Delete

def bmbm(width = 0) # :yield: job

[244] Fix | Delete

job = Job.new(width)

[245] Fix | Delete

yield(job)

[246] Fix | Delete

width = job.width + 1

[247] Fix | Delete

sync = STDOUT.sync

[248] Fix | Delete

STDOUT.sync = true

[249] Fix | Delete

[250] Fix | Delete

# rehearsal

[251] Fix | Delete

puts 'Rehearsal '.ljust(width+CAPTION.length,'-')

[252] Fix | Delete

ets = job.list.inject(Tms.new) { |sum,(label,item)|

[253] Fix | Delete

print label.ljust(width)

[254] Fix | Delete

res = Benchmark.measure(&item)

[255] Fix | Delete

print res.format

[256] Fix | Delete

sum + res

[257] Fix | Delete

}.format("total: %tsec")

[258] Fix | Delete

print " #{ets}\n\n".rjust(width+CAPTION.length+2,'-')

[259] Fix | Delete

[260] Fix | Delete

# take

[261] Fix | Delete

print ' '*width + CAPTION

[262] Fix | Delete

job.list.map { |label,item|

[263] Fix | Delete

GC.start

[264] Fix | Delete

print label.ljust(width)

[265] Fix | Delete

Benchmark.measure(label, &item).tap { |res| print res }

[266] Fix | Delete

}

[267] Fix | Delete

ensure

[268] Fix | Delete

STDOUT.sync = sync unless sync.nil?

[269] Fix | Delete

end

[270] Fix | Delete

[271] Fix | Delete

# :stopdoc:

[272] Fix | Delete

case

[273] Fix | Delete

when defined?(Process::CLOCK_MONOTONIC)

[274] Fix | Delete

BENCHMARK_CLOCK = Process::CLOCK_MONOTONIC

[275] Fix | Delete

else

[276] Fix | Delete

BENCHMARK_CLOCK = Process::CLOCK_REALTIME

[277] Fix | Delete

end

[278] Fix | Delete

# :startdoc:

[279] Fix | Delete

[280] Fix | Delete

#

[281] Fix | Delete

# Returns the time used to execute the given block as a

[282] Fix | Delete

# Benchmark::Tms object.

[283] Fix | Delete

#

[284] Fix | Delete

def measure(label = "") # :yield:

[285] Fix | Delete

t0, r0 = Process.times, Process.clock_gettime(BENCHMARK_CLOCK)

[286] Fix | Delete

yield

[287] Fix | Delete

t1, r1 = Process.times, Process.clock_gettime(BENCHMARK_CLOCK)

[288] Fix | Delete

Benchmark::Tms.new(t1.utime - t0.utime,

[289] Fix | Delete

t1.stime - t0.stime,

[290] Fix | Delete

t1.cutime - t0.cutime,

[291] Fix | Delete

t1.cstime - t0.cstime,

[292] Fix | Delete

r1 - r0,

[293] Fix | Delete

label)

[294] Fix | Delete

end

[295] Fix | Delete

[296] Fix | Delete

#

[297] Fix | Delete

# Returns the elapsed real time used to execute the given block.

[298] Fix | Delete

#

[299] Fix | Delete

def realtime # :yield:

[300] Fix | Delete

r0 = Process.clock_gettime(BENCHMARK_CLOCK)

[301] Fix | Delete

yield

[302] Fix | Delete

Process.clock_gettime(BENCHMARK_CLOCK) - r0

[303] Fix | Delete

end

[304] Fix | Delete

[305] Fix | Delete

module_function :benchmark, :measure, :realtime, :bm, :bmbm

[306] Fix | Delete

[307] Fix | Delete

#

[308] Fix | Delete

# A Job is a sequence of labelled blocks to be processed by the

[309] Fix | Delete

# Benchmark.bmbm method. It is of little direct interest to the user.

[310] Fix | Delete

#

[311] Fix | Delete

class Job # :nodoc:

[312] Fix | Delete

#

[313] Fix | Delete

# Returns an initialized Job instance.

[314] Fix | Delete

# Usually, one doesn't call this method directly, as new

[315] Fix | Delete

# Job objects are created by the #bmbm method.

[316] Fix | Delete

# +width+ is a initial value for the label offset used in formatting;

[317] Fix | Delete

# the #bmbm method passes its +width+ argument to this constructor.

[318] Fix | Delete

#

[319] Fix | Delete

def initialize(width)

[320] Fix | Delete

@width = width

[321] Fix | Delete

@list = []

[322] Fix | Delete

end

[323] Fix | Delete

[324] Fix | Delete

#

[325] Fix | Delete

# Registers the given label and block pair in the job list.

[326] Fix | Delete

#

[327] Fix | Delete

def item(label = "", &blk) # :yield:

[328] Fix | Delete

raise ArgumentError, "no block" unless block_given?

[329] Fix | Delete

label = label.to_s

[330] Fix | Delete

w = label.length

[331] Fix | Delete

@width = w if @width < w

[332] Fix | Delete

@list << [label, blk]

[333] Fix | Delete

self

[334] Fix | Delete

end

[335] Fix | Delete

[336] Fix | Delete

alias report item

[337] Fix | Delete

[338] Fix | Delete

# An array of 2-element arrays, consisting of label and block pairs.

[339] Fix | Delete

attr_reader :list

[340] Fix | Delete

[341] Fix | Delete

# Length of the widest label in the #list.

[342] Fix | Delete

attr_reader :width

[343] Fix | Delete

end

[344] Fix | Delete

[345] Fix | Delete

#

[346] Fix | Delete

# This class is used by the Benchmark.benchmark and Benchmark.bm methods.

[347] Fix | Delete

# It is of little direct interest to the user.

[348] Fix | Delete

#

[349] Fix | Delete

class Report # :nodoc:

[350] Fix | Delete

#

[351] Fix | Delete

# Returns an initialized Report instance.

[352] Fix | Delete

# Usually, one doesn't call this method directly, as new

[353] Fix | Delete

# Report objects are created by the #benchmark and #bm methods.

[354] Fix | Delete

# +width+ and +format+ are the label offset and

[355] Fix | Delete

# format string used by Tms#format.

[356] Fix | Delete

#

[357] Fix | Delete

def initialize(width = 0, format = nil)

[358] Fix | Delete

@width, @format, @list = width, format, []

[359] Fix | Delete

end

[360] Fix | Delete

[361] Fix | Delete

#

[362] Fix | Delete

# Prints the +label+ and measured time for the block,

[363] Fix | Delete

# formatted by +format+. See Tms#format for the

[364] Fix | Delete

# formatting rules.

[365] Fix | Delete

#

[366] Fix | Delete

def item(label = "", *format, &blk) # :yield:

[367] Fix | Delete

print label.to_s.ljust(@width)

[368] Fix | Delete

@list << res = Benchmark.measure(label, &blk)

[369] Fix | Delete

print res.format(@format, *format)

[370] Fix | Delete

res

[371] Fix | Delete

end

[372] Fix | Delete

[373] Fix | Delete

alias report item

[374] Fix | Delete

[375] Fix | Delete

# An array of Benchmark::Tms objects representing each item.

[376] Fix | Delete

attr_reader :list

[377] Fix | Delete

end

[378] Fix | Delete

[379] Fix | Delete

[380] Fix | Delete

[381] Fix | Delete

#

[382] Fix | Delete

# A data object, representing the times associated with a benchmark

[383] Fix | Delete

# measurement.

[384] Fix | Delete

#

[385] Fix | Delete

class Tms

[386] Fix | Delete

[387] Fix | Delete

# Default caption, see also Benchmark::CAPTION

[388] Fix | Delete

CAPTION = " user system total real\n"

[389] Fix | Delete

[390] Fix | Delete

# Default format string, see also Benchmark::FORMAT

[391] Fix | Delete

FORMAT = "%10.6u %10.6y %10.6t %10.6r\n"

[392] Fix | Delete

[393] Fix | Delete

# User CPU time

[394] Fix | Delete

attr_reader :utime

[395] Fix | Delete

[396] Fix | Delete

# System CPU time

[397] Fix | Delete

attr_reader :stime

[398] Fix | Delete

[399] Fix | Delete

# User CPU time of children

[400] Fix | Delete

attr_reader :cutime

[401] Fix | Delete

[402] Fix | Delete

# System CPU time of children

[403] Fix | Delete

attr_reader :cstime

[404] Fix | Delete

[405] Fix | Delete

# Elapsed real time

[406] Fix | Delete

attr_reader :real

[407] Fix | Delete

[408] Fix | Delete

# Total time, that is +utime+ + +stime+ + +cutime+ + +cstime+

[409] Fix | Delete

attr_reader :total

[410] Fix | Delete

[411] Fix | Delete

# Label

[412] Fix | Delete

attr_reader :label

[413] Fix | Delete

[414] Fix | Delete

#

[415] Fix | Delete

# Returns an initialized Tms object which has

[416] Fix | Delete

# +utime+ as the user CPU time, +stime+ as the system CPU time,

[417] Fix | Delete

# +cutime+ as the children's user CPU time, +cstime+ as the children's

[418] Fix | Delete

# system CPU time, +real+ as the elapsed real time and +label+ as the label.

[419] Fix | Delete

#

[420] Fix | Delete

def initialize(utime = 0.0, stime = 0.0, cutime = 0.0, cstime = 0.0, real = 0.0, label = nil)

[421] Fix | Delete

@utime, @stime, @cutime, @cstime, @real, @label = utime, stime, cutime, cstime, real, label.to_s

[422] Fix | Delete

@total = @utime + @stime + @cutime + @cstime

[423] Fix | Delete

end

[424] Fix | Delete

[425] Fix | Delete

#

[426] Fix | Delete

# Returns a new Tms object whose times are the sum of the times for this

[427] Fix | Delete

# Tms object, plus the time required to execute the code block (+blk+).

[428] Fix | Delete

#

[429] Fix | Delete

def add(&blk) # :yield:

[430] Fix | Delete

self + Benchmark.measure(&blk)

[431] Fix | Delete

end

[432] Fix | Delete

[433] Fix | Delete

#

[434] Fix | Delete

# An in-place version of #add.

[435] Fix | Delete

#

[436] Fix | Delete

def add!(&blk)

[437] Fix | Delete

t = Benchmark.measure(&blk)

[438] Fix | Delete

@utime = utime + t.utime

[439] Fix | Delete

@stime = stime + t.stime

[440] Fix | Delete

@cutime = cutime + t.cutime

[441] Fix | Delete

@cstime = cstime + t.cstime

[442] Fix | Delete

@real = real + t.real

[443] Fix | Delete

self

[444] Fix | Delete

end

[445] Fix | Delete

[446] Fix | Delete

#

[447] Fix | Delete

# Returns a new Tms object obtained by memberwise summation

[448] Fix | Delete

# of the individual times for this Tms object with those of the other

[449] Fix | Delete

# Tms object.

[450] Fix | Delete

# This method and #/() are useful for taking statistics.

[451] Fix | Delete

#

[452] Fix | Delete

def +(other); memberwise(:+, other) end

[453] Fix | Delete

[454] Fix | Delete

#

[455] Fix | Delete

# Returns a new Tms object obtained by memberwise subtraction

[456] Fix | Delete

# of the individual times for the other Tms object from those of this

[457] Fix | Delete

# Tms object.

[458] Fix | Delete

#

[459] Fix | Delete

def -(other); memberwise(:-, other) end

[460] Fix | Delete

[461] Fix | Delete

#

[462] Fix | Delete

# Returns a new Tms object obtained by memberwise multiplication

[463] Fix | Delete

# of the individual times for this Tms object by _x_.

[464] Fix | Delete

#

[465] Fix | Delete

def *(x); memberwise(:*, x) end

[466] Fix | Delete

[467] Fix | Delete

#

[468] Fix | Delete

# Returns a new Tms object obtained by memberwise division

[469] Fix | Delete

# of the individual times for this Tms object by _x_.

[470] Fix | Delete

# This method and #+() are useful for taking statistics.

[471] Fix | Delete

#

[472] Fix | Delete

def /(x); memberwise(:/, x) end

[473] Fix | Delete

[474] Fix | Delete

#

[475] Fix | Delete

# Returns the contents of this Tms object as

[476] Fix | Delete

# a formatted string, according to a format string

[477] Fix | Delete

# like that passed to Kernel.format. In addition, #format

[478] Fix | Delete

# accepts the following extensions:

[479] Fix | Delete

#

[480] Fix | Delete

# <tt>%u</tt>:: Replaced by the user CPU time, as reported by Tms#utime.

[481] Fix | Delete

# <tt>%y</tt>:: Replaced by the system CPU time, as reported by #stime (Mnemonic: y of "s*y*stem")

[482] Fix | Delete

# <tt>%U</tt>:: Replaced by the children's user CPU time, as reported by Tms#cutime

[483] Fix | Delete

# <tt>%Y</tt>:: Replaced by the children's system CPU time, as reported by Tms#cstime

[484] Fix | Delete

# <tt>%t</tt>:: Replaced by the total CPU time, as reported by Tms#total

[485] Fix | Delete

# <tt>%r</tt>:: Replaced by the elapsed real time, as reported by Tms#real

[486] Fix | Delete

# <tt>%n</tt>:: Replaced by the label string, as reported by Tms#label (Mnemonic: n of "*n*ame")

[487] Fix | Delete

#

[488] Fix | Delete

# If _format_ is not given, FORMAT is used as default value, detailing the

[489] Fix | Delete

# user, system and real elapsed time.

[490] Fix | Delete

#

[491] Fix | Delete

def format(format = nil, *args)

[492] Fix | Delete

str = (format || FORMAT).dup

[493] Fix | Delete

str.gsub!(/(%[-+.\d]*)n/) { "#{$1}s" % label }

[494] Fix | Delete

str.gsub!(/(%[-+.\d]*)u/) { "#{$1}f" % utime }

[495] Fix | Delete

str.gsub!(/(%[-+.\d]*)y/) { "#{$1}f" % stime }

[496] Fix | Delete

str.gsub!(/(%[-+.\d]*)U/) { "#{$1}f" % cutime }

[497] Fix | Delete

str.gsub!(/(%[-+.\d]*)Y/) { "#{$1}f" % cstime }

[498] Fix | Delete

str.gsub!(/(%[-+.\d]*)t/) { "#{$1}f" % total }

[499] Fix | Delete