Struct Password 

pub struct Password(/* private fields */);

Secret string memory-wiped on drop and obfuscated in Debug output.

Implementations

impl Password

pub fn new<S: Into<String>>(pass: S) -> Self

Wrap a plaintext password. The value is zeroized when the Password is dropped.

pub fn as_str(&self) -> &str

Borrow the password as a string slice. Use sparingly — the returned reference is not zeroized.

pub fn as_imap_quoted(&self) -> Result<String, ClientError>

Render the password as an IMAP quoted string (RFC 9051 §4.3), escaping the two quoted-specials (\, ").

Returns ClientError::CommandFailed if the secret contains a character that cannot appear inside a quoted string (CR, LF, NUL, or any 8-bit byte). Callers facing an 8-bit secret should use Session::authenticate_plain which transports the secret as base64 over a SASL exchange.

Trait Implementations

impl Clone for Password

fn clone(&self) -> Password

Returns a duplicate of the value.

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

Performs copy-assignment from source.

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 Zeroize for Password

fn zeroize(&mut self)

Zero out this object from memory using Rust intrinsics which ensure the zeroization operation is not “optimized away” by the compiler.