satcat5::io::CobsDecoder Class Reference

Detailed Description

Inline COBS decoder.

See also

codec_cobs.h.

Definition at line 74 of file codec_cobs.h.

#include <codec_cobs.h>

Inheritance diagram for satcat5::io::CobsDecoder:

Collaboration diagram for satcat5::io::CobsDecoder:

Public Member Functions
	CobsDecoder (satcat5::io::Writeable *dst)
	Permanently link this encoder to an output object.
unsigned	get_write_space () const override
	How many bytes can be written without blocking? More...
void	write_u8 (u8 data)
	One of many functions for writing integer/floating point values, see details. More...
virtual void	write_bytes (unsigned nbytes, const void *src)
	Write 0 or more bytes from a buffer. More...
void	write_str (const char *str)
	Write the contents of a null-terminated string. More...
virtual bool	write_finalize ()
	Mark end of frame and release temporary working data. More...
virtual void	write_abort ()
	If possible, abort the current partially-written packet. More...
template<class T >
void	write_obj (const T &obj)
	Templated wrapper for any object with the following method: void write_to(satcat5::io::Writeable* wr) const;

Protected Attributes
friend	LimitedWrite
friend	WriteableBroadcast
friend	WriteableRedirect

Private Member Functions
void	write_next (u8 data) override
	Write the next byte to the underlying buffer or device. More...
void	write_overflow () override
	Optional error handling for write overflow. More...

Private Attributes
satcat5::io::Writeable *const	m_dst
u8	m_blk
u8	m_ctr
u8	m_ovr

Member Function Documentation

get_write_space()

unsigned CobsDecoder::get_write_space ( ) const

overridevirtual

How many bytes can be written without blocking?

Child objects of io::Writeable MUST override this method.

Implements satcat5::io::Writeable.

Definition at line 98 of file codec_cobs.cc.

write_abort()

void Writeable::write_abort ( )

virtualinherited

If possible, abort the current partially-written packet.

Child objects of io::Writeable SHOULD override this method if it is practical to prevent in-progress data from being relayed downstream.

Reimplemented in satcat5::port::Mailmap, satcat5::io::PacketBuffer, satcat5::io::MultiWriter, satcat5::io::WriteableRedirect, satcat5::io::ArrayWrite, satcat5::io::CounterInline, satcat5::io::ChecksumRxCommon, satcat5::io::ChecksumTxCommon, satcat5::io::WriteableBroadcast, satcat5::eth::SwitchPort, satcat5::io::HdlcEncoder::ByteStuff, and satcat5::io::FileWriter.

Definition at line 186 of file io_writeable.cc.

write_bytes()

void Writeable::write_bytes ( unsigned  nbytes, const void *  src  )

virtualinherited

Write 0 or more bytes from a buffer.

Child objects of io::Writeable MAY override write_bytes as needed for performance.

Reimplemented in satcat5::port::MailmapAligned, satcat5::port::Mailmap, satcat5::io::PacketBuffer, satcat5::io::MultiWriter, satcat5::io::MultiPacket::Overwriter, satcat5::io::NullWrite, satcat5::io::WriteableRedirect, satcat5::io::LimitedWrite, satcat5::io::CounterInline, satcat5::io::WriteableBroadcast, and satcat5::io::FileWriter.

Definition at line 170 of file io_writeable.cc.

write_finalize()

bool Writeable::write_finalize ( )

virtualinherited

Mark end of frame and release temporary working data.

Child objects of io::Writeable SHOULD override this method to mark frame bounds.

Returns

True if successful, false on error.

Reimplemented in satcat5::port::Mailmap, satcat5::io::PacketBuffer, satcat5::io::MultiWriterBypass, satcat5::io::MultiWriter, satcat5::io::WriteableRedirect, satcat5::io::ArrayWrite, satcat5::io::WriteableThrottle, satcat5::io::CounterInline, satcat5::io::WriteableBroadcastAny, satcat5::io::WriteableBroadcast, satcat5::eth::SwitchPort, satcat5::eth::ChecksumRx, satcat5::eth::ChecksumTx, satcat5::crc16::XmodemRx, satcat5::crc16::XmodemTx, satcat5::crc16::KermitRx, satcat5::crc16::KermitTx, satcat5::io::SlipEncoder, satcat5::io::HdlcEncoder::ByteStuff, satcat5::io::CobsEncoder, satcat5::coap::Connection, satcat5::test::EthernetInterface, satcat5::io::BufferedTee, satcat5::io::WritePcapInterface, satcat5::io::WritePcap, satcat5::io::FileWriter, and satcat5::util::ChatPrinter.

Definition at line 185 of file io_writeable.cc.

write_next()

void CobsDecoder::write_next ( u8  data )

overrideprivatevirtual

Write the next byte to the underlying buffer or device.

Child objects of io::Writeable MUST override this method.

Implements satcat5::io::Writeable.

Definition at line 103 of file codec_cobs.cc.

write_overflow()

void CobsDecoder::write_overflow ( )

overrideprivatevirtual

Optional error handling for write overflow.

Child objects of io::Writeable MAY override this method for error handling.

Reimplemented from satcat5::io::Writeable.

Definition at line 132 of file codec_cobs.cc.

write_str()

void Writeable::write_str ( const char *  str )

inherited

Write the contents of a null-terminated string.

Note: Null-termination is not copied to the output.

Definition at line 180 of file io_writeable.cc.

write_u8()

void Writeable::write_u8 ( u8  data )

inherited

One of many functions for writing integer/floating point values, see details.

Several functions are provided for reading and writing scalar types to/from io::Readable and io::Writeable instances. Since there are many of these that are frequently inherited, they are hidden from documentation. These functions follow a shared template:

• read_ or write_ prefix.
• u for unsigned, s for signed, f for floating-point.
• Data-type width in bits.
  • Available widths for ints: 8/16/24/32/48/64.
  • Available widths for floats: 32/64.
• l suffix if little-endian, no suffix if big-endian.

Example: write_s48l is "Write 48 bits (6 bytes) to this io::Writeable as a signed value in little-endian order".

Definition at line 20 of file io_writeable.cc.

---

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

• codec_cobs.h
• codec_cobs.cc