Enum PacketParserResult 

pub enum PacketParserResult<'a> {
    Some(PacketParser<'a>),
    EOF(PacketParserEOF<'a>),
}

The result of parsing a packet.

This type is returned by PacketParser::next, PacketParser::recurse, PacketParserBuilder::build, and the implementation of PacketParser’s Parse trait. The result is either Some(PacketParser), indicating successful parsing of a packet, or EOF(PacketParserEOF) if the end of the input stream has been reached.

Variants

Some(PacketParser<'a>)

A PacketParser for the next packet.

EOF(PacketParserEOF<'a>)

Information about a fully parsed packet sequence.

Implementations

impl<'a> PacketParserResult<'a>

pub fn is_eof(&self) -> bool

Returns true if the result is EOF.

pub fn is_some(&self) -> bool

Returns true if the result is Some.

pub fn expect(self, msg: &str) -> PacketParser<'a>

Unwraps a result, yielding the content of an Some.

Panics

Panics if the value is an EOF, with a panic message including the passed message, and the information in the PacketParserEOF object.

pub fn unwrap(self) -> PacketParser<'a>

Unwraps a result, yielding the content of an Some.

Panics

Panics if the value is an EOF, with a panic message including the information in the PacketParserEOF object.

pub fn as_ref(&self) -> Result<&PacketParser<'a>, &PacketParserEOF<'a>>

Converts from PacketParserResult to Result<&PacketParser, &PacketParserEOF>.

Produces a new Result, containing references into the original PacketParserResult, leaving the original in place.

pub fn as_mut( &mut self, ) -> Result<&mut PacketParser<'a>, &mut PacketParserEOF<'a>>

Converts from PacketParserResult to Result<&mut PacketParser, &mut PacketParserEOF>.

Produces a new Result, containing mutable references into the original PacketParserResult, leaving the original in place.

pub fn take(&mut self) -> PacketParserResult<'a>

Takes the value out of the PacketParserResult, leaving a EOF in its place.

The EOF left in place carries a PacketParserEOF with default values.

pub fn map<U, F>(self, f: F) -> Result<U, PacketParserEOF<'a>>

where F: FnOnce(PacketParser<'a>) -> U,

Maps a PacketParserResult to Result<PacketParser, PacketParserEOF> by applying a function to a contained Some value, leaving an EOF value untouched.

Trait Implementations

impl<'a> Debug for PacketParserResult<'a>

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

Formats the value using the given formatter.

impl<'a> From<PacketParserResult<'a>> for CertParser<'a>

fn from(ppr: PacketParserResult<'a>) -> CertParser<'a>

Initializes a CertParser from a PacketParser.

impl<'a> Parse<'a, PacketParserResult<'a>> for PacketParser<'a>

fn from_buffered_reader<R>(reader: R) -> Result<PacketParserResult<'a>, Error>

where R: BufferedReader<Cookie> + 'a,

Starts parsing an OpenPGP object stored in a BufferedReader object.

This function returns a PacketParser for the first packet in the stream.

fn from_reader<R>(reader: R) -> Result<T, Error>

where R: 'a + Read + Send + Sync,

Reads from the given reader.

fn from_file<P>(path: P) -> Result<T, Error>

where P: AsRef<Path>,

Reads from the given file.

fn from_bytes<D>(data: &'a D) -> Result<T, Error>

where D: AsRef<[u8]> + Send + Sync + ?Sized,

Reads from the given slice.

impl TryFrom<PacketParserResult<'_>> for Cert

fn try_from(ppr: PacketParserResult<'_>) -> Result<Cert, Error>

Returns the Cert found in the packet stream.

If the sequence contains multiple certificates (i.e., it is a keyring), or the certificate is followed by an invalid packet this function will fail. To parse keyrings, use CertParser instead of this function.

type Error = Error

The type returned in the event of a conversion error.

impl<'a> TryFrom<PacketParserResult<'a>> for PacketPile

fn try_from(ppr: PacketParserResult<'a>) -> Result<PacketPile, Error>

Reads all the packets from a PacketParser, and turns them into a message.

Note: this assumes that ppr points to a top-level packet.

type Error = Error

The type returned in the event of a conversion error.