Class: Digest::Class

Inherits:
Object
  • Object
show all
Includes:
Instance
Defined in:
digest.c,
lib/digest.rb

Overview

This module stands as a base class for digest implementation classes.

Direct Known Subclasses

Base, SHA2

Class Method Summary collapse

Methods included from Instance

#<<, #==, #block_length, #digest, #digest!, #digest_length, #file, #finish, #hexdigest, #hexdigest!, #inspect, #length, #new, #reset, #size, #to_s, #update

Class Method Details

.Digest::Class.digest(string, *parameters) ⇒ Object

Returns the hash value of a given string. This is equivalent to Digest::Class.new(*parameters).digest(string), where extra parameters, if any, are passed through to the constructor and the string is passed to #digest().




# File 'digest.c'

/*
 * call-seq:
 *     Digest::Class.digest(string, *parameters) -> hash_string
 *
 * Returns the hash value of a given _string_.  This is equivalent to
 * Digest::Class.new(*parameters).digest(string), where extra
 * _parameters_, if any, are passed through to the constructor and the
 * _string_ is passed to #digest().
 */
static VALUE
rb_digest_class_s_digest(int argc, VALUE *argv, VALUE klass)
{
    VALUE str;
    volatile VALUE obj;

    if (argc < 1) {
        rb_raise(rb_eArgError, "no data given");
    }

    str = *argv++;
    argc--;

    StringValue(str);

    obj = rb_obj_alloc(klass);
    rb_obj_call_init(obj, argc, argv);

    return rb_funcall(obj, id_digest, 1, str);
}

.file(name) ⇒ Object

creates a digest object and reads a given file, name.

p Digest::SHA256.file("X11R6.8.2-src.tar.bz2").hexdigest
# => "f02e3c85572dc9ad7cb77c2a638e3be24cc1b5bea9fdbb0b0299c9668475c534"



28
29
30
 
# File 'lib/digest.rb', line 28

def self.file(name)
  new.file(name)
end

.Digest::Class.hexdigest(string[, ...]) ⇒ Object

Returns the hex-encoded hash value of a given string. This is almost equivalent to Digest.hexencode(Digest::Class.new(*parameters).digest(string)).




# File 'digest.c'

/*
 * call-seq:
 *     Digest::Class.hexdigest(string[, ...]) -> hash_string
 *
 * Returns the hex-encoded hash value of a given _string_.  This is
 * almost equivalent to
 * Digest.hexencode(Digest::Class.new(*parameters).digest(string)).
 */
static VALUE
rb_digest_class_s_hexdigest(int argc, VALUE *argv, VALUE klass)
{
    return hexencode_str_new(rb_funcall2(klass, id_digest, argc, argv));
}