class Digest::SHA2

Родительский класс:: Digest::Class

Класс-поставщик метаданных для SHA256, SHA384 и SHA512.

В стандарте FIPS 180-2 описано семейство алгоритмов хеширования SHA2. В нём определены три алгоритма:

один обрабатывает блоки по 512 бит и возвращает дайджест размером 256 бит (SHA256),
один обрабатывает блоки по 1024 бита и возвращает дайджест размером 384 бита (SHA384),
и один обрабатывает блоки по 1024 бита и возвращает дайджест размером 512 бит (SHA512).

Примеры

require 'digest'

# Compute a complete digest
Digest::SHA2.hexdigest 'abc'          # => "ba7816bf8..."
Digest::SHA2.new(256).hexdigest 'abc' # => "ba7816bf8..."
Digest::SHA256.hexdigest 'abc'        # => "ba7816bf8..."

Digest::SHA2.new(384).hexdigest 'abc' # => "cb00753f4..."
Digest::SHA384.hexdigest 'abc'        # => "cb00753f4..."

Digest::SHA2.new(512).hexdigest 'abc' # => "ddaf35a19..."
Digest::SHA512.hexdigest 'abc'        # => "ddaf35a19..."

# Compute digest by chunks
sha2 = Digest::SHA2.new               # =>#<Digest::SHA2:256>
sha2.update "ab"
sha2 << "c"                           # alias for #update
sha2.hexdigest                        # => "ba7816bf8..."

# Use the same object to compute another digest
sha2.reset
sha2 << "message"
sha2.hexdigest                        # => "ab530a13e..."

Открытые методы класса

Digest::SHA2.new(bitlen = 256) → digest_obj Показать исходный код

# File ext/digest/sha2/lib/sha2.rb, line 61
def initialize(bitlen = 256)
  case bitlen
  when 256
    @sha2 = Digest::SHA256.new
  when 384
    @sha2 = Digest::SHA384.new
  when 512
    @sha2 = Digest::SHA512.new
  else
    raise ArgumentError, "unsupported bit length: %s" % bitlen.inspect
  end
  @bitlen = bitlen
end

Создаёт новый объект хеширования SHA2 с заданной длиной в битах.

Допустимые длины в битах: 256, 384 и 512.

Открытые методы экземпляра

digest_obj << string → digest_obj

Псевдоним для: update

block_length → Integer Показать исходный код

# File ext/digest/sha2/lib/sha2.rb, line 112
def block_length
  @sha2.block_length
end

Возвращает длину блока дайджеста в байтах.

Digest::SHA256.new.block_length * 8
# => 512
Digest::SHA384.new.block_length * 8
# => 1024
Digest::SHA512.new.block_length * 8
# => 1024

digest_length → Integer Показать исходный код

# File ext/digest/sha2/lib/sha2.rb, line 130
def digest_length
  @sha2.digest_length
end

Возвращает длину хеш-значения (дайджеста) в байтах.

Digest::SHA256.new.digest_length * 8
# => 256
Digest::SHA384.new.digest_length * 8
# => 384
Digest::SHA512.new.digest_length * 8
# => 512

Например, дайджесты, созданные с помощью Digest::SHA256, всегда имеют размер 32 байта (256 бит).

reset → digest_obj Показать исходный код

# File ext/digest/sha2/lib/sha2.rb, line 79
def reset
  @sha2.reset
  self
end

Сбрасывает дайджест в исходное состояние и возвращает self.

update(string) → digest_obj Показать исходный код

# File ext/digest/sha2/lib/sha2.rb, line 89
def update(str)
  @sha2.update(str)
  self
end

Обновляет дайджест с помощью заданной строки и возвращает self.

Также имеет псевдоним: <<

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