Struct Label 

pub struct Label([u8; 40]);

40-bytes long textual description of the object.

Examples

Converting a string to a Label:

use signstar_yubihsm2::backup::Label;

let label: Label = "test".parse()?;

assert_eq!(label.to_string(), "test");

Tuple Fields

0: [u8; 40]

Trait Implementations

impl AsRef<[u8; 40]> for Label

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

Returns a reference to the underlying buffer.

Examples

use signstar_yubihsm2::backup::Label;

let label: Label = "test".parse()?;

assert_eq!(label.as_ref().len(), 40);

impl Clone for Label

fn clone(&self) -> Label

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Label

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

Formats the value using the given formatter.

impl Display for Label

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

Converts the label to a string and writes it to a given formatter.

Note that if the underlying buffer does not contain valid UTF-8 data, the conversion is lossy.

Examples

use std::fmt::Write;

use signstar_yubihsm2::backup::Label;

let label: Label = "test".parse()?;

let mut str = String::new();
write!(str, "{label}")?;

assert_eq!(str, "test");

impl From<&[u8; 40]> for Label

fn from(value: &[u8; 40]) -> Self

Creates a new Label from a slice of 40 bytes.

Examples

use signstar_yubihsm2::backup::Label;

let label = Label::from(&[0; 40]);

assert_eq!(label.to_string(), "");

impl FromStr for Label

fn from_str(s: &str) -> Result<Self, Self::Err>

Creates a new Label from a string slice.

The text must be no longer than 40 bytes and may be empty.

Examples

Converting a string to Label:

use signstar_yubihsm2::backup::{Error, Label};

let label: Label = "test".parse()?;

assert_eq!(label.to_string(), "test");

// When the string is too long [`Error::LabelLength`] is returned:

assert!(matches!(
    "a".repeat(50).parse::<Label>(),
    Err(Error::LabelLength { .. })
));

Errors

Returns an error if the string is longer than 40 bytes.

type Err = Error

The associated error which can be returned from parsing.