Extended maintenance of Ruby 1.9.3 ended on February 23, 2015. Read more

In Files

  • digest/sha2/lib/sha2.rb

Class/Module Index [+]

Quicksearch

Digest::SHA2

A meta digest provider class for SHA256, SHA384 and SHA512.

Public Class Methods

Digest::SHA2.new(bitlen = 256) → digest_obj click to toggle source

Creates a new SHA2 hash object with a given bit length.

Valid bit lengths are 256, 384 and 512.

 
               # File digest/sha2/lib/sha2.rb, line 26
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
            

Public Instance Methods

<<(str) click to toggle source
Alias for: update
block_length → Integer click to toggle source

Returns the block length of the digest in bytes.

Digest::SHA256.new.digest_length * 8
# => 512
Digest::SHA384.new.digest_length * 8
# => 1024
Digest::SHA512.new.digest_length * 8
# => 1024
 
               # File digest/sha2/lib/sha2.rb, line 77
def block_length
  @sha2.block_length
end
            
digest_length → Integer click to toggle source

Returns the length of the hash value of the digest in bytes.

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

For example, digests produced by Digest::SHA256 will always be 32 bytes (256 bits) in size.

 
               # File digest/sha2/lib/sha2.rb, line 95
def digest_length
  @sha2.digest_length
end
            
reset → digest_obj click to toggle source

Resets the digest to the initial state and returns self.

 
               # File digest/sha2/lib/sha2.rb, line 44
def reset
  @sha2.reset
  self
end
            
update(string) → digest_obj click to toggle source
digest_obj << string → digest_obj

Updates the digest using a given string and returns self.

 
               # File digest/sha2/lib/sha2.rb, line 54
def update(str)
  @sha2.update(str)
  self
end
            
Also aliased as: <<

Commenting is here to help enhance the documentation. For example, code samples, or clarification of the documentation.

If you have questions about Ruby or the documentation, please post to one of the Ruby mailing lists. You will get better, faster, help that way.

If you wish to post a correction of the docs, please do so, but also file bug report so that it can be corrected for the next release. Thank you.

If you want to help improve the Ruby documentation, please visit Documenting-ruby.org.