CryptoSys PKI Pro Manual

CNV_HexFilter

Removes non-hexadecimal characters from a string.

VBA/VB6 Syntax

Public Declare Function CNV_HexFilter Lib "diCrPKI.dll" (ByVal strOutput As String, ByVal strInput As String, ByVal nStrLen As Long) As Long

nRet = CNV_HexFilter(strOutput, strInput, nStrLen)

C/C++ Syntax

long __stdcall CNV_HexFilter(char *szOutput, const char *szInput, long nStrLen);

Parameters

szOutput
[out] to receive filtered characters.
szInput
[in] to be filtered.
nStrLen
[in] specifying the length of the input string.

Returns (VBA/C)

If successful, the return value is the number of characters in the filtered string; otherwise it returns a negative error code.

VBA Wrapper Syntax

Public Function cnvHexFilter (szHex As String) As String

.NET Equivalent

Cnv.HexFilter Method

Remarks

Specify a zero nOutChars or an empty string for szOutput to find the required length of the output string. ANSI C users must add one to this value when allocating memory.

Assumes that the output string is at least as long as the input string.

Example (VBA core function)

Wrapper function to return a filtered string directly:

Public Function cnvHexFilter(strHex As String) As String
    Dim strFiltered As String
    Dim nDataLen As Long
    
    strFiltered = String(Len(strHex), " ")
    nDataLen = CNV_HexFilter(strFiltered, strHex, Len(strHex))
    strFiltered = Left$(strFiltered, nDataLen)
    cnvHexFilter = strFiltered
End Function

See Also

CNV_HexStrFromBytes CNV_BytesFromHexStr

[Contents] [Index]

[PREV: CNV_CheckUTF8File...]   [Contents]   [Index]   
   [NEXT: CNV_HexStrFromBytes...]

Copyright © 2004-24 D.I. Management Services Pty Ltd. All rights reserved. Generated 2024-09-23T07:52:09Z.