Struct EncryptedData 

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

A newtype over Vec<u8> representing binary (non‑armored) age encrypted data.

Overview

This is the raw, binary output of age encryption when no armor is requested. It is the complement of [ArmoredData]. The inner bytes are the direct result of the age::Encryptor writer — a compact, but not human‑readable, ciphertext.

Why wrap a Vec<u8>?

Exactly the same reasons as ArmoredData:

• Type distinctness – prevents mixing up plaintext, encrypted data, and other byte buffers at the type level.
• Controlled construction – new is pub(crate), so only the encryption functions can create an EncryptedData. This guarantees that any EncryptedData you hold came from a successful encryption operation.
• Ergonomics – implements [AsRef<[u8]>], From conversions, and provides accessor methods. The [Display] implementation shows only the byte length to avoid dumping binary data to the screen.

Examples

use age_crypto::encrypt;

let encrypted: EncryptedData = encrypt(b"secret", &["age1..."]).unwrap();
println!("{}", encrypted);          // [EncryptedData: 512 bytes]
let raw: &[u8] = encrypted.as_bytes();
let owned: Vec<u8> = encrypted.to_vec();

Implementations

impl EncryptedData

pub fn as_bytes(&self) -> &[u8]

Returns the binary ciphertext as a byte slice.

This provides read‑only access to the encrypted bytes. Use it when you need to write the data to a file or network stream.

Example

std::fs::write("data.age", encrypted.as_bytes())?;

pub fn to_vec(&self) -> Vec<u8>

Converts the ciphertext into an owned Vec<u8>.

This clones the internal buffer. If you need to take ownership without cloning, use [From<EncryptedData> for Vec<u8>] instead, which consumes the EncryptedData.

pub fn len(&self) -> usize

Returns the number of bytes in the ciphertext.

pub fn is_empty(&self) -> bool

Returns true if the ciphertext is empty.

Note: a valid age encrypted stream is never truly empty because it always contains at least a header. However, this method is provided for consistency.

Trait Implementations

impl AsRef<[u8]> for EncryptedData

Allows &EncryptedData to be used wherever &[u8] is expected.

This means you can pass an EncryptedData directly to functions that take a byte slice, such as write_all or copy_to.

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for EncryptedData

fn clone(&self) -> EncryptedData

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EncryptedData

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

Formats the value using the given formatter.

impl Display for EncryptedData

Displays a description showing the byte length only.

Printing raw binary data is seldom useful and could clutter output or accidentally expose ciphertext. The Display implementation limits itself to a short, human‑readable summary.

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

Formats the value using the given formatter.

impl From<EncryptedData> for Vec<u8>

Extracts the raw byte vector from the wrapper.

This consumes the EncryptedData, giving you full ownership of the underlying Vec<u8> without cloning.

fn from(data: EncryptedData) -> Self

Converts to this type from the input type.

impl From<Vec<u8>> for EncryptedData

Converts an owned Vec<u8> into an EncryptedData.

Caution: No validation is performed. The caller must guarantee that the bytes constitute a valid age binary ciphertext. In normal use, only the encryption functions should use this conversion.

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

Converts to this type from the input type.

impl PartialEq for EncryptedData

fn eq(&self, other: &EncryptedData) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for EncryptedData

impl StructuralPartialEq for EncryptedData