epics::pvAccess::HexDump Class Reference

#include "hexDump.h"

Public Member Functions
	HexDump (const char *buf, size_t len)
	HexDump (const pvData::ByteBuffer &buf, size_t size=(size_t)-1, size_t offset=0u)
	~HexDump ()
HexDump &	limit (size_t n=(size_t)-1)
	safety limit on max bytes printed More...
HexDump &	bytesPerGroup (size_t n=(size_t)-1)
	insert a space after this many bytes More...
HexDump &	bytesPerLine (size_t n=(size_t)-1)
	start a new line after this many bytes More...

Friends
epicsShareFunc friend std::ostream &	operator<< (std::ostream &strm, const HexDump &hex)

Detailed Description

Definition at line 32 of file hexDump.h.

Constructor & Destructor Documentation

epics::pvAccess::HexDump::HexDump	(	const char *	buf,
		size_t	len
	)

Definition at line 21 of file hexDump.cpp.

    :buf(buf)
    ,buflen(len)
    ,_limit(1024u)
    ,_groupBy(4u)
    ,_perLine(16u)
{}

epics::pvAccess::HexDump::HexDump ( const pvData::ByteBuffer &  buf, size_t  size = (size_t)-1, size_t  offset = 0u  )

explicit

Definition at line 29 of file hexDump.cpp.

    :buf(bb.getBuffer() + bb.getPosition())
    ,buflen(bb.getRemaining())
    ,_limit((size_t)-1)
    ,_groupBy(4u)
    ,_perLine(16u)
{
    if(offset > buflen)
        offset = buflen;
    buf    += offset;
    buflen -= offset;
    if(buflen > size)
        buflen = size;
}

epics::pvAccess::HexDump::~HexDump

(

)

Definition at line 45 of file hexDump.cpp.

{}

Member Function Documentation

HexDump& epics::pvAccess::HexDump::bytesPerGroup ( size_t  n = (size_t)-1 )

inline

insert a space after this many bytes

Definition at line 46 of file hexDump.h.

{ _groupBy = n; return *this; }

HexDump& epics::pvAccess::HexDump::bytesPerLine ( size_t  n = (size_t)-1 )

inline

start a new line after this many bytes

Definition at line 48 of file hexDump.h.

{ _perLine = n; return *this; }

HexDump& epics::pvAccess::HexDump::limit ( size_t  n = (size_t)-1 )

inline

safety limit on max bytes printed

Definition at line 44 of file hexDump.h.

{ _limit = n; return *this; }

Friends And Related Function Documentation

epicsShareFunc friend std::ostream& operator<< ( std::ostream &  strm, const HexDump &  hex  )

friend

Definition at line 69 of file hexDump.cpp.

{
    const size_t len = std::min(hex.buflen, hex._limit);
    // find address width in hex chars
    // find bit width, rounded up to 8 bits, divide down to bytes
    const size_t addrwidth = bits2bytes(ilog2(len))*2u;
    size_t nlines = len/hex._perLine;

    if(len%hex._perLine)
        nlines++;

    for(size_t l=0; l<nlines; l++)
    {
        size_t start = l*hex._perLine;
        strm<<"0x"<<std::hex<<std::setw(addrwidth)<<std::setfill('0')<<start;

        // print hex chars
        for(size_t col=0; col<hex._perLine; col++)
        {
            if(col%hex._groupBy == 0) {
                strm<<' ';
            }
            if(start+col < len) {
                strm<<std::hex<<std::setw(2)<<std::setfill('0')<<unsigned(hex.buf[start+col]&0xff);
            } else {
                strm<<"  ";
            }
        }

        strm<<' ';

        // printable ascii
        for(size_t col=0; col<hex._perLine && start+col<len; col++)
        {
            if(col%hex._groupBy == 0) {
                strm<<' ';
            }
            char val = hex.buf[start+col]&0xff;
            if(val>=' ' && val<='~') {
                strm<<val;
            } else {
                strm<<'.';
            }
        }

        strm<<'\n';
    }

    return strm;
}

---

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

• modules/pvAccess/src/utils/pv/hexDump.h
• modules/pvAccess/src/utils/hexDump.cpp