Struct SecureString

Source

pub struct SecureString { /* private fields */ }

Expand description

A securely allocated, growable UTF-8 string, just like std::string::String.

It is a wrapper around SecureVec and inherits all of its security guarantees.

Access to the string contents is provided through scoped methods like unlock_str, which ensure the memory is only unlocked for the briefest possible time.

§Notes

If you return a new allocated String from one of the unlock methods you are responsible for zeroizing the memory.

§Example

use secure_types::{SecureString, Zeroize};

// Create a SecureString
let mut secret = SecureString::from("my_super_secret");

// The memory is locked here

// Safely append more data.
secret.push_str("_password");

// The memory is locked here.

// Use a scope to safely access the content as a &str.
secret.unlock_str(|exposed_str| {
    assert_eq!(exposed_str, "my_super_secret_password");
});
 
// Not recommended but if you allocate a new String make sure to zeroize it
let mut exposed = secret.unlock_str(|exposed_str| {
    String::from(exposed_str)
});
 
// Do what you need to to do with the new string
// When you are done with it, zeroize it
exposed.zeroize();

// When `secret` is dropped, its data zeroized.

Implementations§

Source §

pub fn len(&self) -> usize

Returns the length of the inner SecureVec

If you want the character length use char_len

Source

pub fn is_empty(&self) -> bool

Source

pub fn drain(&mut self, range: Range<usize>)

Source

pub fn char_len(&self) -> usize

Source

pub fn push_str(&mut self, string: &str)

Push a &str into the SecureString

Source

pub fn unlock_str<F, R>(&self, f: F) -> R
where F: FnOnce(&str) -> R,

Immutable access as &str

Source

pub fn unlock_mut<F, R>(&mut self, f: F) -> R
where F: FnOnce(&mut SecureString) -> R,

Mutable access to the SecureString

Source

pub fn insert_text_at_char_idx( &mut self, char_idx: usize, text_to_insert: &str, ) -> usize

Inserts text at the given character index

§Returns

The number of characters inserted

§Example

use secure_types::SecureString;

let mut string = SecureString::from("GreekFeta");
string.insert_text_at_char_idx(9, "Cheese");
string.unlock_str(|str| {
    assert_eq!(str, "GreekFetaCheese");
});

Source

pub fn delete_text_char_range(&mut self, char_range: Range<usize>)

Deletes the text in the given character range

§Example

use secure_types::SecureString;

let mut string = SecureString::from("GreekFetaCheese");
string.delete_text_char_range(9..15);
string.unlock_str(|str| {
    assert_eq!(str, "GreekFeta");
});