Click here to Skip to main content
15,860,861 members
Articles / Programming Languages / C++
Article

CHash 1.5 - An MFC hashing class

Rate me:
Please Sign up or sign in to vote.
4.09/5 (61 votes)
8 Aug 20052 min read 208.2K   8.5K   106   48
An MFC implementation of hashing files and strings with CRC32, GOST-Hash, MD2, MD4, MD5, SHA-1 and SHA-2 (256/384/512).

Image 1

Introduction

A few times I've seen implementations of individual hashing algorithms, and thought it may be a good idea to group them together in an easy to use class. Well, here it is.

What are hashes anyway?

Hashes are a string of letters/numbers. They are used as a representation of an amount of data, but they are one way, you cannot go from a hash back to the original data; as hashes are fixed length, you also cannot determine the length or amount of the data represented. This lends hashes to practical security uses, as well as integrity uses.

Why use hashes?

There are multiple uses for hashes, the main one being data integrity. For example, a P2P client would use hashes to validate a file on completion, to check it's not corrupt or "fake". In this way, by generating a hash of a file, you can compare it against another hash, and check whether the files are the same.

Using the code

Putting CHash into use is relatively simple.

The main functions that will be used are:

  • DoHash
  • SetHashAlgorithm
  • SetHashFile
  • SetHashOperation
  • SetHashString

An example of hashing a string with MD5:

// Define a CHash object
CHash hashObj;

// Set the algorithm
hashObj.SetHashAlgorithm(MD5);

// Set the operation
hashObj.SetHashOperation(STRING_HASH);

// Set the string
hashObj.SetHashString("String to hash");

// Hash the string
CString outHash = hashObj.DoHash();

An example of hashing a file with SHA-1:

// Define a CHash object
CHash hashObj;

// Set the algorithm
hashObj.SetHashAlgorithm(SHA1);

// Set the operation
hashObj.SetHashOperation(FILE_HASH);

// Set the file
hashObj.SetHashFile("C:\\Windows\\Explorer.exe");

// Hash the file
CString outHash = hashObj.DoHash();

The code is the same throughout, except for SHA-2, which has an extra function, SetSHA2Strength, which takes one parameter, the strength of the hash, which can be 256, 384 or 512.

An example usage of this is:

// Define a CHash object
CHash hashObj;

// Set the operation
hashObj.SetHashOperation(FILE_HASH);

// Set the algorithm
hashObj.SetHashAlgorithm(SHA2);

// Set the SHA-2 strength
hashObj.SetSHA2Strength(256);

// Set the file
hashObj.SetHashFile("C:\\Windows\\Explorer.exe");

// Hash the file
CString outHash = hashObj.DoHash();

Choosing which algorithms to include

In version 1.5, I made the class modular, so you can exclude/include specific algorithms (cutting down on unnecessary code if you don't want certain ones). To choose which you want to use, go to CHash.h, and find:

// Choose which algorithms you want
// Put 1s to support algorithms, else 0 to not support

Under here you will find defines such as:

#define        SUPPORT_CRC32          1

Change the 1s to 0s if you wish to exclude an algorithm.

Hashing styles

In version 1.2, I added hashing styles. This allows the programmer to customize the output hashes. There are four styles:

  • Lowercase, no spaces:
    b4df98798c02b7c7a500d18632bf5b7d
  • Lowercase, spaces:
    b4 df 98 79 8c 02 b7 c7 a5 00 d1 86 32 bf 5b 7d
  • Uppercase, no spaces:
    B4DF98798C02B7C7A500D18632BF5B7Dd
  • Uppercase, spaces:
    B4 DF 98 79 8C 02 B7 C7 A5 00 D1 86 32 BF 5B 7D

These can be set with SetHashFormat().

Acknowledgements

  • Thanks to Dominik Reichl for his excellent ReHash program.
  • Thanks to Markku-Juhani O. Saarinen for his GOST-Hash implementation.
  • Thanks to Dr. Brian Gladman for the SHA-1/SHA-2 implementations.

History

  • 1.0
    • 1st May, 2005: First public release.
  • 1.1
    • 2nd May, 2005: Added SetHashAlgorithm() and DoHash() as recommended.
  • 1.2
    • 3rd May, 2005:
      • Added hashing styles.
      • Added the GOSTHash algorithm.
      • Added GetHashAlgorithm().
      • Rewrote the hashing functions to be more efficient.
  • 1.3
    • 4th May, 2005: Updated the demo project.
  • 1.5
    • 8th May, 2005:
      • Added CRC32.
      • Made the class "modular" so that you can exclude algorithms from compile.
      • Added GetHashFormat().
      • Updated the code as suggested.
  • 1.6
    • 3rd August, 2005:
      • Fixed a memory leak.
      • Made each hash more efficient, tidied up code in general.
  • License

    This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

    A list of licenses authors might use can be found here


    Written By
    CEO
    United States United States
    This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

    Comments and Discussions

     
    GeneralMy vote of 5 Pin
    toann29-Jul-11 7:41
    toann29-Jul-11 7:41 
    Generalsome function suggestions Pin
    xtrmblop20-May-10 4:54
    xtrmblop20-May-10 4:54 
    Generalsmall bug in CHash.cpp Pin
    xtrmblop20-May-10 0:15
    xtrmblop20-May-10 0:15 
    GeneralRe: small bug in CHash.cpp Pin
    Omar.Pessoa26-Jan-12 0:13
    Omar.Pessoa26-Jan-12 0:13 
    Generalsmall bug [modified] Pin
    kurt_c7-Nov-08 2:04
    kurt_c7-Nov-08 2:04 
    Generalerror when choosing algorithms to support Pin
    breakpoint4-Apr-06 1:00
    breakpoint4-Apr-06 1:00 
    GeneralDecrypt back to plaintext Pin
    shinyhui26-Sep-05 14:27
    shinyhui26-Sep-05 14:27 
    GeneralRe: Decrypt back to plaintext Pin
    .rich.w27-Sep-05 4:07
    .rich.w27-Sep-05 4:07 
    GeneralRe: Decrypt back to plaintext Pin
    shinyhui27-Sep-05 14:17
    shinyhui27-Sep-05 14:17 
    GeneralRe: Decrypt back to plaintext Pin
    .rich.w28-Sep-05 4:00
    .rich.w28-Sep-05 4:00 
    GeneralRe: Decrypt back to plaintext Pin
    shinyhui28-Sep-05 15:10
    shinyhui28-Sep-05 15:10 
    GeneralRe: Decrypt back to plaintext Pin
    JamieMcLaughlin6-Mar-06 20:37
    JamieMcLaughlin6-Mar-06 20:37 
    GeneralI vote Pin
    Peder White19-Aug-05 4:40
    Peder White19-Aug-05 4:40 
    Generalreturn values not defined... Pin
    bevpet9-Aug-05 6:48
    bevpet9-Aug-05 6:48 
    QuestionWhy all these seperate classes? Pin
    Geert van Horrik9-Aug-05 1:07
    Geert van Horrik9-Aug-05 1:07 
    AnswerRe: Why all these seperate classes? Pin
    bevpet9-Aug-05 6:59
    bevpet9-Aug-05 6:59 
    GeneralRe: Why all these seperate classes? Pin
    .rich.w19-Aug-05 19:59
    .rich.w19-Aug-05 19:59 
    I'll try make a DLL compilation soon.
    GeneralUsing hash on files Pin
    Geert van Horrik9-Aug-05 1:04
    Geert van Horrik9-Aug-05 1:04 
    GeneralRe: Using hash on files Pin
    .rich.w19-Aug-05 19:58
    .rich.w19-Aug-05 19:58 
    JokeC-Hash :-) Pin
    Nish Nishant8-Aug-05 23:34
    sitebuilderNish Nishant8-Aug-05 23:34 
    GeneralRe: C-Hash :-) Pin
    bevpet9-Aug-05 6:56
    bevpet9-Aug-05 6:56 
    Generalcheck if file exists before attempting hash Pin
    bevpet27-May-05 6:02
    bevpet27-May-05 6:02 
    GeneralRe: check if file exists before attempting hash Pin
    .rich.w31-May-05 0:37
    .rich.w31-May-05 0:37 
    Generalnice work.. Pin
    bevpet26-May-05 18:00
    bevpet26-May-05 18:00 
    GeneralSpeed Pin
    dennisV24-May-05 19:08
    dennisV24-May-05 19:08 

    General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

    Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.