Struct openssl::hash::Hasher

[+] Show declaration

pub struct Hasher { /* fields omitted */ }

[−] Expand description

Provides message digest (hash) computation.

Examples

Calculate a hash in one go:

use openssl::hash::{hash, MessageDigest};

let data = b"\x42\xF4\x97\xE0";
let spec = b"\x7c\x43\x0f\x17\x8a\xef\xdf\x14\x87\xfe\xe7\x14\x4e\x96\x41\xe2";
let res = hash(MessageDigest::md5(), data).unwrap();
assert_eq!(&*res, spec);

Supply the input in chunks:

use openssl::hash::{Hasher, MessageDigest};

let data = [b"\x42\xF4", b"\x97\xE0"];
let spec = b"\x7c\x43\x0f\x17\x8a\xef\xdf\x14\x87\xfe\xe7\x14\x4e\x96\x41\xe2";
let mut h = Hasher::new(MessageDigest::md5()).unwrap();
h.update(data[0]).unwrap();
h.update(data[1]).unwrap();
let res = h.finish().unwrap();
assert_eq!(&*res, spec);

Warning

Don't actually use MD5 and SHA-1 hashes, they're not secure anymore.

Don't ever hash passwords, use the functions in the pkcs5 module or bcrypt/scrypt instead.

Methods

impl Hasher

[−]

pub fn new(ty: MessageDigest) -> Result<Hasher, ErrorStack>

[−]

Creates a new Hasher with the specified hash type.

pub fn update(&mut self, data: &[u8]) -> Result<(), ErrorStack>

[−]

Feeds data into the hasher.

pub fn finish(&mut self) -> Result<DigestBytes, ErrorStack>

[−]

Returns the hash of the data written and resets the hasher.

Trait Implementations

impl Sync for Hasher

impl Send for Hasher

impl Clone for Hasher

[+]

Important traits for Hasher

impl Write for Hasher

fn clone(&self) -> Hasher

[−]

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

[−]

Performs copy-assignment from source.

impl Drop for Hasher

[+]

fn drop(&mut self)

[−]

Executes the destructor for this type.

impl Write for Hasher

[+]

fn write(&mut self, buf: &[u8]) -> Result<usize>

[−]

Write a buffer into this object, returning how many bytes were written.

fn flush(&mut self) -> Result<()>

[−]

Flush this output stream, ensuring that all intermediately buffered contents reach their destination.

fn write_all(&mut self, buf: &[u8]) -> Result<(), Error>

[−]

Attempts to write an entire buffer into this write.

fn write_fmt(&mut self, fmt: Arguments) -> Result<(), Error>

[−]

Writes a formatted string into this writer, returning any error encountered.

fn by_ref(&mut self) -> &mut Self

[−]

Creates a "by reference" adaptor for this instance of Write.