QuickHash Library

Type Library

CRC16C_FinalHex

void CRC16C_FinalHex( [in,out]CRC16C_Context* pContext,[out]CRC16C_HexDigest* pDigest, [ in ]boolean bUpper );
 

Parameters

pContext

    [in/out] A memory buffer that is used as the context.

     Note. All predefined types are specified in the Predefined Types List.

 pDigest

    [out] A memory buffer that will receive the checksum as an ASCII null-terminated string.

     Note. All predefined types are specified in the Predefined Types List.

 bUpper

    [in] Uppercase flag. If bUpper is False, the received checksum represents a lowercase string, otherwise it represents an uppercase string.

Remarks

Call this function to retrieve the CRC16C checksum from the pContext context. The checksum is retrieved as an ASCII null-terminated hexadecimal string in the pDigest memory buffer.

After the CRC16C_FinalHex function  is performed, the context is initialized for new calculations, as it would be called CRC16C_Init again.

Note. Before the first call to CRC16C_Update, CRC16C_UpdateStr, CRC16C_Final or CRC16C_FinalHex functions, the context must be initialized with CRC16C_Init.

VB Example

Private Sub MyButton_Click()   

    Dim Context As CRC16C_Context

    Dim Checksum As CRC16C_HexDigest

    Dim MyStrData As String

    MyStrData = "Hello World!"

    Dim nLen As Long

    nLen = Len(MyStrData)

    'Convert the string to byte array

    Dim MyBinData() As Byte

    ReDim MyBinData(1 To nLen)    

    For i = 1 To nLen

        MyBinData(i) = Asc(Mid(MyStrData, i, 1))

    Next i    

    'Initialize the context

    CRC16C_Init Context

    'Update the context with first part

    Dim nFirstLen As Long

    nFirstLen = nLen / 3

    CRC16C_Update Context, MyBinData(1), nFirstLen

    'Update the context with second part

    CRC16C_Update Context, MyBinData(nFirstLen + 1), nLen - nFirstLen

    'Get the checksum

    CRC16C_FinalHex Context, Checksum, True

    'Show the hexadecimal representation of the checksum

    MsgBox QHASH_ASCIItoBSTR(Checksum.Value(0))

End Sub

Type Library Overview   |   Type Library Functions   |   Useful Links   |   HashCalc

See Also    CRC16C_Final, CRC16C_Update, CRC16C_UpdateStr, CRC16C_Init, QHASH_ASCIItoBSTR