Spec-Zone.ru › Ruby 2.5

class Benchmark::Tms

Родитель:
Объект

Объект данных, представляющий время, связанное с измерением производительности.

Константы

CAPTION

Стандартная подпись, см. также Benchmark::CAPTION

FORMAT

Стандартная строка формата, см. также Benchmark::FORMAT

Атрибуты

cstime[Ч]

Время процессора системы дочерних потоков

cutime[Ч]

Время процессора пользователя дочерних потоков

label[Ч]

Метка

real[Ч]

Прошедшее реальное время

stime[Ч]

Время процессора системы

total[Ч]

Общее время, это utime + stime + cutime + cstime

utime[Ч]

Время процессора пользователя

Общедоступные методы класса

new(utime = 0.0, stime = 0.0, cutime = 0.0, cstime = 0.0, real = 0.0, label = nil) Показать исходный код
# File lib/benchmark.rb, line 426
def initialize(utime = 0.0, stime = 0.0, cutime = 0.0, cstime = 0.0, real = 0.0, label = nil)
  @utime, @stime, @cutime, @cstime, @real, @label = utime, stime, cutime, cstime, real, label.to_s
  @total = @utime + @stime + @cutime + @cstime
end

Возвращает инициализированный объект Tms, у которого utime как время процессора пользователя, stime как время процессора системы, cutime как время процессора пользователя дочерних потоков, cstime как время процессора системы дочерних потоков, real как прошедшее реальное время и label как метка.

Общедоступные методы экземпляра

*(x) Показать исходный код
# File lib/benchmark.rb, line 471
def *(x); memberwise(:*, x) end

Возвращает новый объект Tms, полученный путём поэлементного умножения отдельных времен для этого объекта Tms на x.

+(other) Показать исходный код
# File lib/benchmark.rb, line 458
def +(other); memberwise(:+, other) end

Возвращает новый объект Tms, полученный путём поэлементного суммирования отдельных времен для этого объекта Tms с временами другого объекта Tms. Этот метод и #/() полезны для подсчёта статистики.

-(other) Показать исходный код
# File lib/benchmark.rb, line 465
def -(other); memberwise(:-, other) end

Возвращает новый объект Tms, полученный путём поэлементного вычитания отдельных времен другого объекта Tms из времен этого объекта Tms.

/(x) Показать исходный код
# File lib/benchmark.rb, line 478
def /(x); memberwise(:/, x) end

Возвращает новый объект Tms, полученный путём поэлементного деления отдельных времен для этого объекта Tms на x. Этот метод и #+() полезны для подсчёта статистики.

add() { || ... } Показать исходный код
# File lib/benchmark.rb, line 435
def add(&blk) # :yield:
  self + Benchmark.measure(&blk)
end

Возвращает новый объект Tms, чьи времена являются суммой времён для этого объекта Tms, плюс время, необходимое для выполнения кодового блока (blk).

add!(&blk) Показать исходный код
# File lib/benchmark.rb, line 442
def add!(&blk)
  t = Benchmark.measure(&blk)
  @utime  = utime + t.utime
  @stime  = stime + t.stime
  @cutime = cutime + t.cutime
  @cstime = cstime + t.cstime
  @real   = real + t.real
  self
end

Метод замены для add.

format(format = nil, *args) Показать исходный код
# File lib/benchmark.rb, line 497
def format(format = nil, *args)
  str = (format || FORMAT).dup
  str.gsub!(/(%[-+.\d]*)n/) { "#{$1}s" % label }
  str.gsub!(/(%[-+.\d]*)u/) { "#{$1}f" % utime }
  str.gsub!(/(%[-+.\d]*)y/) { "#{$1}f" % stime }
  str.gsub!(/(%[-+.\d]*)U/) { "#{$1}f" % cutime }
  str.gsub!(/(%[-+.\d]*)Y/) { "#{$1}f" % cstime }
  str.gsub!(/(%[-+.\d]*)t/) { "#{$1}f" % total }
  str.gsub!(/(%[-+.\d]*)r/) { "(#{$1}f)" % real }
  format ? str % args : str
end

Возвращает содержимое этого объекта Tms в виде отформатированной строки, в соответствии со строкой format подобной той, что передаётся в Kernel#format. Кроме того, format принимает следующие расширения:

%u

Заменяется временем процессора пользователя, как сообщает #utime.

%y

Заменяется временем процессора системы, как сообщает stime (Мемоническое правило: y из «s*y*stem»)

%U

Заменяется временем процессора пользователя дочерних потоков, как сообщает #cutime

%Y

Заменяется временем процессора системы дочерних потоков, как сообщает #cstime

%t

Заменяется общим временем процессора, как сообщает #total

%r

Заменяется прошедшим реальным временем, как сообщает #real

%n

Заменяется строкой метки, как сообщает #label (Мемоническое правило: n из «*n*ame»)

Если format не задано, FORMAT используется в качестве значения по умолчанию, подробно описывая время пользователя, системы и реальное прошедшее время.

to_a() Показать исходный код
# File lib/benchmark.rb, line 522
def to_a
  [@label, @utime, @stime, @cutime, @cstime, @real]
end

Возвращает новый массив из 6 элементов, состоящий из метки, времени процессора пользователя, времени процессора системы, времени процессора пользователя дочерних потоков, времени процессора системы дочерних потоков и прошедшего реального времени.

to_s() Показать исходный код
# File lib/benchmark.rb, line 512
def to_s
  format
end

То же самое, что и format.

Защищенные методы экземпляра

memberwise(op, x) Показать исходный код
# File lib/benchmark.rb, line 536
def memberwise(op, x)
  case x
  when Benchmark::Tms
    Benchmark::Tms.new(utime.__send__(op, x.utime),
                       stime.__send__(op, x.stime),
                       cutime.__send__(op, x.cutime),
                       cstime.__send__(op, x.cstime),
                       real.__send__(op, x.real)
                       )
  else
    Benchmark::Tms.new(utime.__send__(op, x),
                       stime.__send__(op, x),
                       cutime.__send__(op, x),
                       cstime.__send__(op, x),
                       real.__send__(op, x)
                       )
  end
end

Возвращает новый объект Tms, полученный путём поэлементной операции op отдельных времен для этого объекта Tms с временами другого объекта Tms.

op может быть математической операцией, такой как +, -, *, /

Ruby Core © 1993–2017 Yukihiro Matsumoto
Licensed under the Ruby License.
Ruby Standard Library © contributors
Licensed under their own licenses.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API