Struct Password 

pub struct Password { /* private fields */ }

A password whose backing memory is securely zeroed when dropped.

This newtype is the primary way to pass passwords into hash, hash_with_salt, and verify. By accepting Password by value, the API guarantees that the caller’s plaintext copy is destroyed (via crypto::secure_zero_bytes()) before the function returns, even on panic.

Examples

use crypt_sha512::{hash, verify, Password};

let h = hash(Password::from("hunter2"), None);
assert_eq!(verify(Password::from("hunter2"), &h), Ok(true));

Password deliberately does not implement Clone, Debug, or core::fmt::Display to discourage accidental duplication or logging of plaintext secrets.

Implementations

impl Password

pub fn from_bytes(bytes: Vec<u8>) -> Self

Construct a Password from raw bytes. The provided Vec<u8> is moved into the Password and will be zeroed when the Password is dropped.

Trait Implementations

impl Debug for Password

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Drop for Password

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl From<&str> for Password

fn from(s: &str) -> Self

Copy the string slice into a new Password. The copy will be zeroed on drop, but the caller’s original &str is unaffected — prefer Password::from(String) when you own the buffer.

impl From<String> for Password

fn from(s: String) -> Self

Move a String’s buffer into a Password. The original String’s allocation becomes the Password’s allocation; no copy is made and the buffer will be zeroed on drop.

impl From<Vec<u8>> for Password

fn from(bytes: Vec<u8>) -> Self

Converts to this type from the input type.