Botan::Stream_Decompression Class Reference

#include <compression.h>

Inheritance diagram for Botan::Stream_Decompression:

Public Member Functions
void	clear () final
void	finish (secure_vector< uint8_t > &buf, size_t offset) final
virtual std::string	name () const =0
void	update (secure_vector< uint8_t > &buf, size_t offset) final

Static Public Member Functions
static std::unique_ptr< Decompression_Algorithm >	create (std::string_view algo_spec)
static std::unique_ptr< Decompression_Algorithm >	create_or_throw (std::string_view algo_spec)

Detailed Description

Used to implement decompression using Compression_Stream

Definition at line 234 of file compression.h.

Member Function Documentation

clear()

void Botan::Stream_Decompression::clear ( )

finalvirtual

Reset the state and abort the current message; start can be called again to process a new message.

Implements Botan::Decompression_Algorithm.

Definition at line 124 of file compress_utils.cpp.

                                 {
   m_stream.reset();
}

create()

std::unique_ptr< Decompression_Algorithm > Botan::Decompression_Algorithm::create ( std::string_view algo_spec )

staticinherited

Create an instance based on a name, or return null if the algo combination cannot be found.

Definition at line 67 of file compression.cpp.

                                                                                          {
#if defined(BOTAN_HAS_ZLIB)
   if(name == "Zlib" || name == "zlib") {
      return std::make_unique<Zlib_Decompression>();
   }
   if(name == "Gzip" || name == "gzip" || name == "gz") {
      return std::make_unique<Gzip_Decompression>();
   }
   if(name == "Deflate" || name == "deflate") {
      return std::make_unique<Deflate_Decompression>();
   }
#endif
 
#if defined(BOTAN_HAS_BZIP2)
   if(name == "bzip2" || name == "bz2" || name == "Bzip2") {
      return std::make_unique<Bzip2_Decompression>();
   }
#endif
 
#if defined(BOTAN_HAS_LZMA)
   if(name == "lzma" || name == "xz" || name == "LZMA") {
      return std::make_unique<LZMA_Decompression>();
   }
#endif
 
   BOTAN_UNUSED(name);
   return nullptr;
}

References BOTAN_UNUSED, and name().

Referenced by create_or_throw(), and Botan::make_decompressor().

create_or_throw()

std::unique_ptr< Decompression_Algorithm > Botan::Decompression_Algorithm::create_or_throw ( std::string_view algo_spec )

staticinherited

Create an instance based on a name

Parameters

algo_spec

algorithm name Throws Lookup_Error if not found.

Definition at line 97 of file compression.cpp.

                                                                                                   {
   if(auto decompressor = Decompression_Algorithm::create(algo)) {
      return decompressor;
   }
   throw Lookup_Error("Decompression", algo, "");
}

References create().

finish()

void Botan::Stream_Decompression::finish ( secure_vector< uint8_t > & final_block, size_t offset )

finalvirtual

Finish decompressing

Decompress the material in the in/out parameter buf. The leading offset bytes of buf are ignored and remain untouched; this can be useful for ignoring packet headers.

This function may throw if the data seems to be invalid.

Parameters

final_block	in/out parameter
offset	an offset into final_block to begin processing

Implements Botan::Decompression_Algorithm.

Definition at line 178 of file compress_utils.cpp.

                                                                            {
   if(buf.size() != offset || m_stream != nullptr) {
      process(buf, offset, m_stream->finish_flag());
   }
 
   if(m_stream) {
      throw Invalid_State(fmt("{} finished but not at stream end", name()));
   }
}

References Botan::fmt(), and Botan::Decompression_Algorithm::name().

name()

virtual std::string Botan::Decompression_Algorithm::name ( ) const

pure virtualinherited

Returns

name of the decompression algorithm

Implemented in Botan::Bzip2_Decompression, Botan::Deflate_Decompression, Botan::Gzip_Decompression, Botan::LZMA_Decompression, and Botan::Zlib_Decompression.

Referenced by create(), and Botan::Stream_Decompression::finish().

update()

void Botan::Stream_Decompression::update ( secure_vector< uint8_t > & buf, size_t offset )

finalvirtual

Process some data.

Parameters

buf	in/out parameter which will possibly be resized or swapped
offset	an offset into blocks to begin processing

Implements Botan::Decompression_Algorithm.

Definition at line 174 of file compress_utils.cpp.

                                                                            {
   process(buf, offset, m_stream->run_flag());
}

---

The documentation for this class was generated from the following files:

• src/lib/compression/compression.h
• src/lib/compression/compress_utils.cpp