//! ASN.1 `PrintableString` support. use crate::{ asn1::AnyRef, ord::OrdIsValueOrd, ByteSlice, DecodeValue, EncodeValue, Error, FixedTag, Header, Length, Reader, Result, StrSlice, Tag, Writer, }; use core::{fmt, ops::Deref, str}; /// ASN.1 `PrintableString` type. /// /// Supports a subset the ASCII character set (described below). /// /// For UTF-8, use [`Utf8StringRef`][`crate::asn1::Utf8StringRef`] instead. /// For the full ASCII character set, use /// [`Ia5StringRef`][`crate::asn1::Ia5StringRef`]. /// /// This is a zero-copy reference type which borrows from the input data. /// /// # Supported characters /// /// The following ASCII characters/ranges are supported: /// /// - `A..Z` /// - `a..z` /// - `0..9` /// - "` `" (i.e. space) /// - `\` /// - `(` /// - `)` /// - `+` /// - `,` /// - `-` /// - `.` /// - `/` /// - `:` /// - `=` /// - `?` #[derive(Copy, Clone, Eq, PartialEq, PartialOrd, Ord)] pub struct PrintableStringRef<'a> { /// Inner value inner: StrSlice<'a>, } impl<'a> PrintableStringRef<'a> { /// Create a new ASN.1 `PrintableString`. pub fn new(input: &'a T) -> Result where T: AsRef<[u8]> + ?Sized, { let input = input.as_ref(); // Validate all characters are within PrintableString's allowed set for &c in input.iter() { match c { b'A'..=b'Z' | b'a'..=b'z' | b'0'..=b'9' | b' ' | b'\'' | b'(' | b')' | b'+' | b',' | b'-' | b'.' | b'/' | b':' | b'=' | b'?' => (), _ => return Err(Self::TAG.value_error()), } } StrSlice::from_bytes(input) .map(|inner| Self { inner }) .map_err(|_| Self::TAG.value_error()) } } impl<'a> Deref for PrintableStringRef<'a> { type Target = StrSlice<'a>; fn deref(&self) -> &Self::Target { &self.inner } } impl AsRef for PrintableStringRef<'_> { fn as_ref(&self) -> &str { self.as_str() } } impl AsRef<[u8]> for PrintableStringRef<'_> { fn as_ref(&self) -> &[u8] { self.as_bytes() } } impl<'a> DecodeValue<'a> for PrintableStringRef<'a> { fn decode_value>(reader: &mut R, header: Header) -> Result { Self::new(ByteSlice::decode_value(reader, header)?.as_slice()) } } impl<'a> EncodeValue for PrintableStringRef<'a> { fn value_len(&self) -> Result { self.inner.value_len() } fn encode_value(&self, writer: &mut dyn Writer) -> Result<()> { self.inner.encode_value(writer) } } impl FixedTag for PrintableStringRef<'_> { const TAG: Tag = Tag::PrintableString; } impl OrdIsValueOrd for PrintableStringRef<'_> {} impl<'a> From<&PrintableStringRef<'a>> for PrintableStringRef<'a> { fn from(value: &PrintableStringRef<'a>) -> PrintableStringRef<'a> { *value } } impl<'a> TryFrom> for PrintableStringRef<'a> { type Error = Error; fn try_from(any: AnyRef<'a>) -> Result> { any.decode_into() } } impl<'a> From> for AnyRef<'a> { fn from(printable_string: PrintableStringRef<'a>) -> AnyRef<'a> { AnyRef::from_tag_and_value(Tag::PrintableString, printable_string.inner.into()) } } impl<'a> fmt::Display for PrintableStringRef<'a> { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { f.write_str(self.as_str()) } } impl<'a> fmt::Debug for PrintableStringRef<'a> { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { write!(f, "PrintableString({:?})", self.as_str()) } } #[cfg(test)] mod tests { use super::PrintableStringRef; use crate::Decode; #[test] fn parse_bytes() { let example_bytes = &[ 0x13, 0x0b, 0x54, 0x65, 0x73, 0x74, 0x20, 0x55, 0x73, 0x65, 0x72, 0x20, 0x31, ]; let printable_string = PrintableStringRef::from_der(example_bytes).unwrap(); assert_eq!(printable_string.as_str(), "Test User 1"); } }