Click here to Skip to main content
15,881,715 members
Articles / Mobile Apps
Article

CrcStream stream checksum calculator

Rate me:
Please Sign up or sign in to vote.
4.66/5 (23 votes)
8 Oct 2005CPOL1 min read 125.1K   2K   43   23
Make better use of time by calculating CRCs on-the-fly.

Introduction

CRC (Cyclic Redundancy Check) is commonly used as a way to confirm that a file had not corrupted during download. While convenient, it takes some time to read the data off of the disk after downloading for the check. It would be convenient if applications checked the CRC on-the-fly during download, so as not to waste idle CPU time and disk read time.

Downloading is done at a relatively leisurely pace (typically anywhere between 5-300kb/s) and over a long period of time, so it makes for a great opportunity to process data without impeding performance. Although ugly and impractical for most applications (it'd be safe to assume that most users think they've "broken the intarweb" when they see a hex number), displaying the CRC to the user immediately as a download finishes can often be a well-appreciated bonus.

This class passively calculates CRCs as data passes through it, ready to be used at any time.

Using the code

To calculate the CRC of a file as it is read to the end, create a new CrcStream passing the FileStream as an argument, and use the ReadCrc property to retrieve the CRC. Be sure to use the new CrcStream instead of the file stream to read from the file; otherwise the checksum will not be calculated.

C#
//Open a file stream, encapsulate it in CrcStream
FileStream file = new FileStream(filename, FileMode.Open);
CrcStream stream = new CrcStream(file);

//Use the file somehow -- in this case, read it as a string
StreamReader reader = new StreamReader(stream);
string text = reader.ReadToEnd();

//Print the checksum
Console.WriteLine("CRC: " + stream.ReadCrc.ToString("X8"));

There are four public members in addition to the abstract Stream overrides:

  • ReadCrc - gets the checksum of the data that was read through the stream.
  • WriteCrc - gets the checksum of the data that was written to the stream.
  • ResetChecksum - resets the CRC values.
  • Stream - gets the encapsulated stream.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Canada Canada
The cows are here to take me home now...

Comments and Discussions

 
GeneralExcellent! Pin
JonKristian31-Mar-11 22:56
JonKristian31-Mar-11 22:56 
GeneralMy vote of 5 Pin
drago697-Mar-11 20:59
drago697-Mar-11 20:59 
GeneralMy vote of 5 Pin
ChewsHumans6-Sep-10 12:00
ChewsHumans6-Sep-10 12:00 
GeneralRe: My vote of 5 Pin
ChewsHumans6-Sep-10 13:11
ChewsHumans6-Sep-10 13:11 
NewsCrcStream in VB.net Pin
Mike19537-Nov-08 11:16
Mike19537-Nov-08 11:16 
Great job! I don't know if this is the right place for this but I needed it in VB.net so I rewrote.
Code is below.


Mike



Imports System
Imports System.Collections.Generic
Imports System.Text
Imports System.IO


Namespace crcCheckSum

''' <summary>
''' Encapsulates a <see cref="System.IO.Stream" /> to calculate the CRC32 checksum on-the-fly as data passes through.
''' </summary>
Public Class CrcStream
Inherits Stream

Private Shared table As UInteger() = GenerateTable()
Private m_stream As Stream
Private m_readCrc As UInteger = 4294967295
Private m_writeCrc As UInteger = 4294967295


''' <summary>
''' Encapsulate a <see cref="System.IO.Stream" />.
''' </summary>
''' <param name="stream">The stream to calculate the checksum for.</param>
Public Sub New(ByVal stream As Stream)
Me.m_stream = stream
End Sub


''' <summary>
''' Gets the underlying stream.
''' </summary>
Public ReadOnly Property Stream() As Stream
Get
Return m_stream
End Get
End Property

Public Overloads Overrides ReadOnly Property CanRead() As Boolean
Get
Return m_stream.CanRead
End Get
End Property

Public Overloads Overrides ReadOnly Property CanSeek() As Boolean
Get
Return m_stream.CanSeek
End Get
End Property

Public Overloads Overrides ReadOnly Property CanWrite() As Boolean
Get
Return m_stream.CanWrite
End Get
End Property

Public Overloads Overrides Sub Flush()
m_stream.Flush()
End Sub

Public Overloads Overrides ReadOnly Property Length() As Long
Get
Exit Property
End Get
End Property

Public Overloads Overrides Property Position() As Long
Get
Exit Property
End Get
Set(ByVal value As Long)
m_stream.Position = value
End Set
End Property

Public Overloads Overrides Function Seek(ByVal offset As Long, ByVal origin As SeekOrigin) As Long
Return m_stream.Seek(offset, origin)
End Function

Public Overloads Overrides Sub SetLength(ByVal value As Long)
m_stream.SetLength(value)
End Sub

Public Overloads Overrides Function Read(ByVal buffer As Byte(), ByVal offset As Integer, ByVal count As Integer) As Integer
count = m_stream.Read(buffer, offset, count)
m_readCrc = CalculateCrc(m_readCrc, buffer, offset, count)
Return count
End Function

Public Overloads Overrides Sub Write(ByVal buffer As Byte(), ByVal offset As Integer, ByVal count As Integer)
m_stream.Write(buffer, offset, count)
m_writeCrc = CalculateCrc(m_writeCrc, buffer, offset, count)
End Sub

Private Function CalculateCrc(ByVal crc As UInteger, ByVal buffer As Byte(), ByVal offset As Integer, ByVal count As Integer) As UInteger
Dim i As Integer = offset, [end] As Integer = offset + count
While i < [end]
crc = (crc >> 8) Xor table((crc Xor buffer(i)) And &HFF)
i += 1
End While
Return crc
End Function

Private Shared Function GenerateTable() As UInteger()
Dim table As UInteger() = New UInteger(255) {}
Dim crc As UInteger
Const poly As UInteger = 3988292384
For i As UInteger = 0 To table.Length - 1
crc = i
For j As Integer = 8 To 1 Step -1
If (crc And 1) = 1 Then
crc = (crc >> 1)
crc = crc Xor poly
Else
crc >>= 1
End If
Next
table(i) = crc
Next
Return table
End Function

''' <summary>
''' Gets the CRC checksum of the data that was read by the stream thus far.
''' </summary>
Public ReadOnly Property ReadCrc() As UInteger
Get
Return m_readCrc 'Xor &HFFFFFFFF
End Get
End Property


''' <summary>
''' Gets the CRC checksum of the data that was written to the stream thus far.
''' </summary>
Public ReadOnly Property WriteCrc() As UInteger
Get
Return m_writeCrc ' Xor &HFFFFFFFF
End Get
End Property

''' <summary>
''' Resets the read and write checksums.
''' </summary>
Public Sub ResetChecksum()
m_readCrc = 4294967295
m_writeCrc = 4294967295
End Sub
End Class
End Namespace
QuestionHow does it handle big files? Pin
rgiejef5-Mar-08 2:27
rgiejef5-Mar-08 2:27 
AnswerRe: How does it handle big files? Pin
Rei Miyasaka5-Mar-08 2:35
Rei Miyasaka5-Mar-08 2:35 
GeneralRe: How does it handle big files? Pin
rgiejef13-Mar-08 1:31
rgiejef13-Mar-08 1:31 
GeneralRe: How does it handle big files? Pin
Rei Miyasaka13-Mar-08 10:05
Rei Miyasaka13-Mar-08 10:05 
GeneralRe: How does it handle big files? Pin
Christian Loft16-Mar-08 21:55
Christian Loft16-Mar-08 21:55 
GeneralRe: How does it handle big files? Pin
Buzz Weetman22-Apr-08 5:01
Buzz Weetman22-Apr-08 5:01 
GeneralRe: How does it handle big files? Pin
Rei Miyasaka22-Apr-08 9:31
Rei Miyasaka22-Apr-08 9:31 
GeneralYet another thank you Pin
zimmerware24-May-07 10:49
zimmerware24-May-07 10:49 
GeneralSmall Enhancement Pin
nerd_biker20-Mar-07 2:37
nerd_biker20-Mar-07 2:37 
GeneralRe: Small Enhancement Pin
Rei Miyasaka20-Mar-07 11:12
Rei Miyasaka20-Mar-07 11:12 
QuestionAdapted Version Pin
FernandoNunes30-Mar-06 2:45
FernandoNunes30-Mar-06 2:45 
AnswerRe: Adapted Version Pin
Rei Miyasaka31-Mar-06 6:49
Rei Miyasaka31-Mar-06 6:49 
GeneralFantastic! Pin
Emma Burrows15-Mar-06 23:57
Emma Burrows15-Mar-06 23:57 
GeneralRe: Fantastic! Pin
Rei Miyasaka16-Mar-06 0:00
Rei Miyasaka16-Mar-06 0:00 
Questionchecksum? Pin
Christoph Ruegg8-Oct-05 13:39
Christoph Ruegg8-Oct-05 13:39 
AnswerYep, checksum Pin
Rei Miyasaka8-Oct-05 14:11
Rei Miyasaka8-Oct-05 14:11 
GeneralRe: Yep, checksum Pin
Christoph Ruegg8-Oct-05 15:01
Christoph Ruegg8-Oct-05 15:01 
GeneralRe: Yep, checksum Pin
Rei Miyasaka9-Oct-05 21:02
Rei Miyasaka9-Oct-05 21:02 

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.