vhex.h

Go to the documentation of this file.

/*
Copyright c1997-2014 Trygve Isaacson. All rights reserved.
This file is part of the Code Vault version 4.1
http://www.bombaydigital.com/
License: MIT. See LICENSE.md in the Vault top level directory.
*/

#ifndef vhex_h
#define vhex_h

#include "vstring.h"

class VTextIOStream;
class VBinaryIOStream;

class VHex {
    public:

        static void bufferToHexString(const Vu8* buffer, Vs64 bufferLength, VString& s, bool wantLeading0x = false);
        static void hexStringToBuffer(const VString& hexDigits, Vu8* buffer, bool hasLeading0x = false);

        static void stringToHex(const VString& text, VString& hexDigits, bool wantLeading0x = false);
        static void hexToString(const VString& hexDigits, VString& text, bool hasLeading0x = false);

        static void byteToHexString(Vu8 byteValue, VString& s);
        static void byteToHexChars(Vu8 byteValue, char* highNibbleChar, char* lowNibbleChar);
        static Vu8 hexStringToByte(const char* twoHexDigits);
        static Vu8 hexCharsToByte(char highNibbleChar, char lowNibbleChar);

        static char nibbleToHexChar(Vu8 nibbleValue);
        static Vu8 hexCharToNibble(char hexChar);

        static void bufferToPrintableASCIIString(const Vu8* buffer, Vs64 bufferLength, VString& s);

        static void readHexDump(VTextIOStream& inputStream, VBinaryIOStream& outputStream);

        VHex(VTextIOStream* outputStream = NULL, int numBytesPerRow = 16, int indentCount = 2, bool labelsInHex = false, bool showASCIIValues = true);
        virtual ~VHex();

        void printHex(const Vu8* buffer, Vs64 length, Vs64 offset = 0);
        void reset();
        void flush();

    private:

        VHex(const VHex&); // not copyable
        VHex& operator=(const VHex&); // not assignable

        void _printPending();

        VTextIOStream*  mOutputStream;      
        int             mNumBytesPerRow;    
        int             mIndentCount;       
        bool            mLabelsInHex;       
        bool            mShowASCIIValues;   
        int             mStartColumn;       
        Vs64            mOffset;            
        int             mPendingBufferUsed; 
        Vu8*            mPendingBuffer;     
        VString         mLineBuffer;        
};

#endif /* vhex_h */