hexdump() [1/2]

std::ostream & tfxx::util::hexdump	(	const void *	pp,
		const unsigned int &	size,
		std::ostream &	os = std::cout,
		const char &	c = '.',
		const unsigned int &	n = 16
	)

output hex dump of memory area.

Parameters

[in]	p	memory location to start dump at
[in]	size	number of bytes to dump in sequence
[in]	os	output stream to which hex dump will be sent
[in]	c	character to be used for non-printable characters
[in]	n	number of bytes per line

Returns

return stream os

Definition at line 44 of file hexdump.cc.

Referenced by hexdump(), and main().

      {
        // obtain pointer with desired type
        const unsigned char* p=reinterpret_cast<const unsigned char*>(pp);
        // character counter in object
        unsigned short int ip=0;
        // character counter in line
        unsigned short int ic=0;
        // character array for printable characters
        char *pc=new char[n];

        // report size of object
        os << "size of object: " << size << " bytes" << std::endl;

        // memorize output stream flags
        std::ostream::fmtflags flags=os.flags();

        // cycle through all bytes in p
        while (ip<size)
        {
          // start line with hex display of byte offset of first character
          os << "0x";
          os << std::hex << std::setfill('0') << std::setw(4) 
             << std::nouppercase << ip;

          // cycle through all characters in line
          while ((ip < size) && (ic<n))
          {
            // extract numerical representation of current character
            unsigned char ch=*p;
            unsigned short int byte(ch);
            // print hex value of current byte value
            os << " ";
            os << std::hex << std::setfill('0') << std::setw(2) 
               << std::nouppercase << byte;
            os.flags(flags);
            // store printable representation of character
            pc[ic]=c;
            if (std::isprint(ch)) { pc[ic]=ch; }
            // step to next byte in object
            ++p;
            ++ip;
            ++ic;
          } // while ((ip < size) && (ic<n))

          // restore state flags of output stream
          os.flags(flags);
          // forward line columns to position of printable characters
          for (unsigned int i=ic; i<n; i++) { os << "   "; }
          // output printable representation of bytes
          os << " ";
          for (unsigned int i=0; i<ic; i++) { os << pc[i]; }
          // end line
          os << std::endl;
          ic=0;
        } // while (ip<size)

        // delete temporary container of printable characters
        delete[] pc;
        return os;
      } // std::ostream& hexdump(const char* p, const unsigned int& size,

Here is the caller graph for this function: