class Digest::SHA2
一个用于 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 点击切换源码
创建一个具有给定位长度的新 SHA2
哈希对象。
有效的位长度为 256、384 和 512。
# File 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
公共实例方法
block_length → Integer 点击切换源码
以字节为单位返回摘要的块长度。
Digest::SHA256.new.block_length * 8 # => 512 Digest::SHA384.new.block_length * 8 # => 1024 Digest::SHA512.new.block_length * 8 # => 1024
# File digest/sha2/lib/sha2.rb, line 112 def block_length @sha2.block_length end
digest_length → Integer 点击切换源码
以字节为单位返回哈希值(摘要)的长度。
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 位)。
# File digest/sha2/lib/sha2.rb, line 130 def digest_length @sha2.digest_length end
reset → digest_obj 点击切换源码
将摘要重置为初始状态并返回 self。
# File digest/sha2/lib/sha2.rb, line 79 def reset @sha2.reset self end
update(string) → digest_obj 点击切换源码
使用给定的 *string* 更新摘要并返回 self。
# File digest/sha2/lib/sha2.rb, line 89 def update(str) @sha2.update(str) self end
别名也为:<<