• Skip to content
  • Skip to link menu
KDE 4.2 API Reference
  • KDE API Reference
  • kdelibs
  • Sitemap
  • Contact Us
 

KDECore

KMD5 Class Reference

An adapted C++ implementation of RSA Data Securities MD5 algorithm. More...

#include <kcodecs.h>

List of all members.


Public Types

typedef unsigned char Digest [16]

Public Member Functions

QByteArray base64Digest ()
void hexDigest (QByteArray &)
QByteArray hexDigest ()
 KMD5 (const QByteArray &a)
 KMD5 (const char *in, int len=-1)
 KMD5 ()
void rawDigest (KMD5::Digest &bin)
const Digest & rawDigest ()
void reset ()
bool update (QIODevice &file)
void update (const QByteArray &in)
void update (const unsigned char *in, int len=-1)
void update (const char *in, int len=-1)
bool verify (const QByteArray &)
bool verify (const KMD5::Digest &digest)
 ~KMD5 ()

Protected Member Functions

void finalize ()
void transform (const unsigned char buffer[64])

Detailed Description

An adapted C++ implementation of RSA Data Securities MD5 algorithm.

The default constructor is designed to provide much the same functionality as the most commonly used C-implementation, while the other three constructors are meant to further simplify the process of obtaining a digest by calculating the result in a single step.

KMD5 is state-based, that means you can add new contents with update() as long as you didn't request the digest value yet. After the digest value was requested, the object is "finalized" and you have to call reset() to be able to do another calculation with it. The reason for this behavior is that upon requesting the message digest KMD5 has to pad the received contents up to a 64 byte boundary to calculate its value. After this operation it is not possible to resume consuming data.

Usage:

A common usage of this class:

 const char* test1;
 KMD5::Digest rawResult;

 test1 = "This is a simple test.";
 KMD5 context (test1);
 cout << "Hex Digest output: " << context.hexDigest().data() << endl;

To cut down on the unnecessary overhead of creating multiple KMD5 objects, you can simply invoke reset() to reuse the same object in making another calculation:

 context.reset ();
 context.update ("TWO");
 context.update ("THREE");
 cout << "Hex Digest output: " << context.hexDigest().data() << endl;

Author:
Dirk Mueller <mueller@kde.org>, Dawit Alemayehu <adawit@kde.org>

Definition at line 331 of file kcodecs.h.


Member Typedef Documentation

typedef unsigned char KMD5::Digest[16]

Definition at line 335 of file kcodecs.h.


Constructor & Destructor Documentation

KMD5::KMD5 (  ) 

Definition at line 743 of file kcodecs.cpp.

KMD5::~KMD5 (  ) 

Definition at line 760 of file kcodecs.cpp.

KMD5::KMD5 ( const char *  in,
int  len = -1 
) [explicit]

Constructor that updates the digest for the given string.

Parameters:
in C string or binary data
len if negative, calculates the length by using strlen on the first parameter, otherwise it trusts the given length (does not stop on NUL byte).

Definition at line 748 of file kcodecs.cpp.

KMD5::KMD5 ( const QByteArray &  a  )  [explicit]

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Same as above except it accepts a QByteArray as its argument.

Definition at line 754 of file kcodecs.cpp.


Member Function Documentation

QByteArray KMD5::base64Digest (  ) 

Returns the value of the calculated message digest in a base64-encoded representation.

Definition at line 912 of file kcodecs.cpp.

void KMD5::finalize (  )  [protected]

finalizes the digest

Definition at line 828 of file kcodecs.cpp.

void KMD5::hexDigest ( QByteArray &  s  ) 

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 902 of file kcodecs.cpp.

QByteArray KMD5::hexDigest (  ) 

Returns the value of the calculated message digest in a hexadecimal representation.

Definition at line 889 of file kcodecs.cpp.

void KMD5::rawDigest ( KMD5::Digest &  bin  ) 

Fills the given array with the binary representation of the message digest.

Use this method if you do not want to worry about making copy of the digest once you obtain it.

Parameters:
bin an array of 16 characters ( char[16] )

Definition at line 882 of file kcodecs.cpp.

const KMD5::Digest & KMD5::rawDigest (  ) 

Returns:
the raw representation of the digest

Definition at line 876 of file kcodecs.cpp.

void KMD5::reset (  ) 

Calling this function will reset the calculated message digest.

Use this method to perform another message digest calculation without recreating the KMD5 object.

Definition at line 924 of file kcodecs.cpp.

void KMD5::transform ( const unsigned char  buffer[64]  )  [protected]

Performs the real update work.

Note that length is implied to be 64.

Definition at line 940 of file kcodecs.cpp.

bool KMD5::update ( QIODevice &  file  ) 

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. reads the data from an I/O device, i.e.

from a file (QFile).

NOTE that the file must be open for reading.

Parameters:
file a pointer to FILE as returned by calls like f{d,re}open
Returns:
false if an error occurred during reading.

Definition at line 817 of file kcodecs.cpp.

void KMD5::update ( const QByteArray &  in  ) 

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Parameters:
in message to be added to the digest (QByteArray).

Definition at line 764 of file kcodecs.cpp.

void KMD5::update ( const unsigned char *  in,
int  len = -1 
)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 774 of file kcodecs.cpp.

void KMD5::update ( const char *  in,
int  len = -1 
)

Updates the message to be digested.

Be sure to add all data before you read the digest. After reading the digest, you can not add more data!

Parameters:
in message to be added to digest
len the length of the given message.

Definition at line 769 of file kcodecs.cpp.

bool KMD5::verify ( const QByteArray &  hexdigest  ) 

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 870 of file kcodecs.cpp.

bool KMD5::verify ( const KMD5::Digest &  digest  ) 

returns true if the calculated digest for the given message matches the given one.

Definition at line 864 of file kcodecs.cpp.


The documentation for this class was generated from the following files:
  • kcodecs.h
  • kcodecs.cpp

KDECore

Skip menu "KDECore"
  • Main Page
  • Modules
  • Namespace List
  • Class Hierarchy
  • Alphabetical List
  • Class List
  • File List
  • Namespace Members
  • Class Members
  • Related Pages

kdelibs

Skip menu "kdelibs"
  • DNSSD
  • Interfaces
  •   KHexEdit
  •   KMediaPlayer
  •   KSpeech
  •   KTextEditor
  • Kate
  • kconf_update
  • KDE3Support
  •   KUnitTest
  • KDECore
  • KDED
  • KDEsu
  • KDEUI
  • KDocTools
  • KFile
  • KHTML
  • KImgIO
  • KInit
  • kio
  • KIOSlave
  • KJS
  •   KJS-API
  •   WTF
  • kjsembed
  • KNewStuff
  • KParts
  • Kross
  • KUtils
  • Nepomuk
  • Plasma
  • Solid
  • Sonnet
  • ThreadWeaver
Generated for kdelibs by doxygen 1.5.7
This website is maintained by Adriaan de Groot and Allen Winter.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal