HashCheckString (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Availability of algorithms

HashCheckString function and UNICODE

See also

HashCheckString (Function)

In french: HashVérifieChaîne

Checks the Hash of a character string for a specific type of algorithm. You have the ability to check:

a simple hash.
a hash with message authentication.

Reminder: The hashing is used to summarize a file or a character string. This summary is called Hash.

Versions 15 and later

This function is now available for PHP sites.

This function is now available for Java applications.

This function is now available for Android applications.

New in version 15

This function is now available for PHP sites.

This function is now available for Java applications.

This function is now available for Android applications.

This function is now available for PHP sites.

This function is now available for Java applications.

This function is now available for Android applications.

Versions 17 and later

This function is now available for iPhone/iPad applications.

New in version 17

This function is now available for iPhone/iPad applications.

Versions 18 and later

This function is now available in Windows Store apps mode.

This function is now available in Android Widget mode.

New in version 18

This function is now available in Windows Store apps mode.

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

This function is now available in Android Widget mode.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Example

// Check the password:
// - Password typed in the "EDT_TypePassword" control
// - The password Hash is found in the "User.HashPassword" item
IF HashCheckString(HA_MD5_128, EDT_TypePassword, ...
User.HashPassword) = True THEN
Info("Password OK.")
// Rest of process
// ...
ELSE
Error("Wrong password.")
// Resume the input
ReturnToCapture(EDT_TypePassword)
END

Syntax

Checking a simple hash Hide the details

<Result> = HashCheckString(<Type of algorithm> , <String> , <Hash>)

<Result>: Boolean

True if the result when <String> was hashed by <Type of algorithm> corresponds to <Hash>,
False otherwise.

<Type of algorithm>: Integer constant

Indicates the type of algorithm used when hashing the <String>:
Versions 22 and later
DJB2 family (Bernstein)
New in version 22
DJB2 family (Bernstein)
DJB2 family (Bernstein)
Versions 22 and later
HA_DJB2_32
Not available.
New in version 22
HA_DJB2_32
Not available.
HA_DJB2_32
Not available.
Versions 22 and later
HA_DJB2_64
Not available.
New in version 22
HA_DJB2_64
Not available.
HA_DJB2_64
Not available.
MD5 family HA_MD5_128
Versions 24 and later
MURMUR family
New in version 24
MURMUR family
MURMUR family
Versions 24 and later
HA_MURMUR_1: Murmur algorithm version 1: 32-bit hash result
Not available.
New in version 24
HA_MURMUR_1: Murmur algorithm version 1: 32-bit hash result
Not available.
HA_MURMUR_1: Murmur algorithm version 1: 32-bit hash result
Not available.
Versions 24 and later
HA_MURMUR_2: Murmur algorithm version 2: 32-bit hash result
Not available.
New in version 24
HA_MURMUR_2: Murmur algorithm version 2: 32-bit hash result
Not available.
HA_MURMUR_2: Murmur algorithm version 2: 32-bit hash result
Not available.
Versions 24 and later
HA_MURMUR_2_64A: Murmur algorithm version 2: 64-bit hash result optimized for 64-bit processors
Not available.
New in version 24
HA_MURMUR_2_64A: Murmur algorithm version 2: 64-bit hash result optimized for 64-bit processors
Not available.
HA_MURMUR_2_64A: Murmur algorithm version 2: 64-bit hash result optimized for 64-bit processors
Not available.
Versions 24 and later
HA_MURMUR_2_64B: Murmur algorithm version 2: 64-bit hash result optimized for 32-bit processors
Not available.
New in version 24
HA_MURMUR_2_64B: Murmur algorithm version 2: 64-bit hash result optimized for 32-bit processors
Not available.
HA_MURMUR_2_64B: Murmur algorithm version 2: 64-bit hash result optimized for 32-bit processors
Not available.
Versions 24 and later
HA_MURMUR_2_A: Incremental Murmur algorithm version 2: 32-bit hash result
Not available.
New in version 24
HA_MURMUR_2_A: Incremental Murmur algorithm version 2: 32-bit hash result
Not available.
HA_MURMUR_2_A: Incremental Murmur algorithm version 2: 32-bit hash result
Not available.
Versions 24 and later
HA_MURMUR_2_BIG_ENDIAN: Murmur algorithm version 2 for big-endian machine: 32-bit hash result
Not available.
New in version 24
HA_MURMUR_2_BIG_ENDIAN: Murmur algorithm version 2 for big-endian machine: 32-bit hash result
Not available.
HA_MURMUR_2_BIG_ENDIAN: Murmur algorithm version 2 for big-endian machine: 32-bit hash result
Not available.
Versions 24 and later
HA_MURMUR_2_ALIGNED: Murmur algorithm version 2 for aligned machine: 32-bit hash result
Not available.
New in version 24
HA_MURMUR_2_ALIGNED: Murmur algorithm version 2 for aligned machine: 32-bit hash result
Not available.
HA_MURMUR_2_ALIGNED: Murmur algorithm version 2 for aligned machine: 32-bit hash result
Not available.
Versions 24 and later
HA_MURMUR_3_32: Murmur algorithm version 3: 32-bit hash result
Not available.
New in version 24
HA_MURMUR_3_32: Murmur algorithm version 3: 32-bit hash result
Not available.
HA_MURMUR_3_32: Murmur algorithm version 3: 32-bit hash result
Not available.
Versions 24 and later
HA_MURMUR_3_128_X86: Murmur algorithm version 3: 128-bit hash result optimized for 32-bit processors
Not available.
New in version 24
HA_MURMUR_3_128_X86: Murmur algorithm version 3: 128-bit hash result optimized for 32-bit processors
Not available.
HA_MURMUR_3_128_X86: Murmur algorithm version 3: 128-bit hash result optimized for 32-bit processors
Not available.
Versions 24 and later
HA_MURMUR_3_128_X64: Murmur algorithm version 3: 128-bit hash result optimized for 64-bit processors
Not available.
New in version 24
HA_MURMUR_3_128_X64: Murmur algorithm version 3: 128-bit hash result optimized for 64-bit processors
Not available.
HA_MURMUR_3_128_X64: Murmur algorithm version 3: 128-bit hash result optimized for 64-bit processors
Not available.
SHA family HA_SHA_160 (also called SHA-1)
HA_SHA_256
HA_SHA_384
HA_SHA_512
Versions 23 and later
SHA-3 family
New in version 23
SHA-3 family
SHA-3 family
Versions 23 and later
HA_SHA3_224
Not available.
New in version 23
HA_SHA3_224
Not available.
HA_SHA3_224
Not available.
Versions 23 and later
HA_SHA3_256
Not available.
New in version 23
HA_SHA3_256
Not available.
HA_SHA3_256
Not available.
Versions 23 and later
HA_SHA3_384
Not available.
New in version 23
HA_SHA3_384
Not available.
HA_SHA3_384
Not available.
Versions 23 and later
HA_SHA3_512
Not available.
New in version 23
HA_SHA3_512
Not available.
HA_SHA3_512
Not available.
RIPEMD family HA_RIPEMD_128
Not available.
HA_RIPEMD_160
Not available.
TIGER family HA_TIGER_128
Not available.
Not available.
HA_TIGER_160
Not available.
Not available.
HA_TIGER_192
Not available.
Not available.
WHIRLPOOL family HA_WHIRLPOOL
Not available.
CKSUM family HA_CKSUM_8
Not available.
HA_CKSUM_16
Not available.
HA_CKSUM_32
Not available.
HA_CKSUM_64
Not available.
MD5/SHA/RIPEMD algorithms: standard cryptographic hash functions.
TIGER/WHIRLPOOL algorithms: hash functions with high cryptographic properties optimized for the 64-bit mode (but can also be used in 32-bit mode).
The TIGER algorithms are not available.
CKSUM algorithms: hash functions with no cryptographic property, should be used to perform low-level checks or with hashing tables.
Versions 22 and later
DJB2 algorithm (Bernstein): hash functions reserved to strings and with no cryptographic property, should be used to perform low-level checks or with hashing tables. Few risks to get an identical hash.
New in version 22
DJB2 algorithm (Bernstein): hash functions reserved to strings and with no cryptographic property, should be used to perform low-level checks or with hashing tables. Few risks to get an identical hash.
DJB2 algorithm (Bernstein): hash functions reserved to strings and with no cryptographic property, should be used to perform low-level checks or with hashing tables. Few risks to get an identical hash.
Versions 24 and later
MURMUR algorithm: very fast hashing functions. This algorithm is used by the "bloom filter" of bitcoin wallets.
New in version 24
MURMUR algorithm: very fast hashing functions. This algorithm is used by the "bloom filter" of bitcoin wallets.
MURMUR algorithm: very fast hashing functions. This algorithm is used by the "bloom filter" of bitcoin wallets.

<String>: Character string (with quotes)

String for which the Hash will be checked.

<Hash>: Character string (with quotes)

Hash of string to check. This Hash must be the result of HashString previously called for <String> on <Type of algorithm>.

Checking a hash with message authentication (HMAC/MURMUR algorithm) Hide the details

<Result> = HashCheckString(<Type of algorithm> , <String> , <Hash> , <Secret key>)

<Result>: Boolean

True if the result when <String> was hashed by <Type of algorithm> corresponds to <Hash>,
False otherwise.

<Type of algorithm>: Integer constant

Indicates the type of HMAC algorithm used when hashing the <String>:
MD5 family HA_HMAC_MD5_128
Versions 24 and later
MURMUR family
New in version 24
MURMUR family
MURMUR family
Versions 24 and later
HA_MURMUR_1: Murmur algorithm version 1: 32-bit hash result
Not available.
New in version 24
HA_MURMUR_1: Murmur algorithm version 1: 32-bit hash result
Not available.
HA_MURMUR_1: Murmur algorithm version 1: 32-bit hash result
Not available.
Versions 24 and later
HA_MURMUR_2: Murmur algorithm version 2: 32-bit hash result
Not available.
New in version 24
HA_MURMUR_2: Murmur algorithm version 2: 32-bit hash result
Not available.
HA_MURMUR_2: Murmur algorithm version 2: 32-bit hash result
Not available.
Versions 24 and later
HA_MURMUR_2_64A: Murmur algorithm version 2: 64-bit hash result optimized for 64-bit processors
Not available.
New in version 24
HA_MURMUR_2_64A: Murmur algorithm version 2: 64-bit hash result optimized for 64-bit processors
Not available.
HA_MURMUR_2_64A: Murmur algorithm version 2: 64-bit hash result optimized for 64-bit processors
Not available.
Versions 24 and later
HA_MURMUR_2_64B: Murmur algorithm version 2: 64-bit hash result optimized for 32-bit processors
Not available.
New in version 24
HA_MURMUR_2_64B: Murmur algorithm version 2: 64-bit hash result optimized for 32-bit processors
Not available.
HA_MURMUR_2_64B: Murmur algorithm version 2: 64-bit hash result optimized for 32-bit processors
Not available.
Versions 24 and later
HA_MURMUR_2_A: Incremental Murmur algorithm version 2: 32-bit hash result
Not available.
New in version 24
HA_MURMUR_2_A: Incremental Murmur algorithm version 2: 32-bit hash result
Not available.
HA_MURMUR_2_A: Incremental Murmur algorithm version 2: 32-bit hash result
Not available.
Versions 24 and later
HA_MURMUR_2_BIG_ENDIAN: Murmur algorithm version 2 for big-endian machine: 32-bit hash result
Not available.
New in version 24
HA_MURMUR_2_BIG_ENDIAN: Murmur algorithm version 2 for big-endian machine: 32-bit hash result
Not available.
HA_MURMUR_2_BIG_ENDIAN: Murmur algorithm version 2 for big-endian machine: 32-bit hash result
Not available.
Versions 24 and later
HA_MURMUR_2_ALIGNED: Murmur algorithm version 2 for aligned machine: 32-bit hash result
Not available.
New in version 24
HA_MURMUR_2_ALIGNED: Murmur algorithm version 2 for aligned machine: 32-bit hash result
Not available.
HA_MURMUR_2_ALIGNED: Murmur algorithm version 2 for aligned machine: 32-bit hash result
Not available.
Versions 24 and later
HA_MURMUR_3_32: Murmur algorithm version 3: 32-bit hash result
Not available.
New in version 24
HA_MURMUR_3_32: Murmur algorithm version 3: 32-bit hash result
Not available.
HA_MURMUR_3_32: Murmur algorithm version 3: 32-bit hash result
Not available.
Versions 24 and later
HA_MURMUR_3_128_X86: Murmur algorithm version 3: 128-bit hash result optimized for 32-bit processors
Not available.
New in version 24
HA_MURMUR_3_128_X86: Murmur algorithm version 3: 128-bit hash result optimized for 32-bit processors
Not available.
HA_MURMUR_3_128_X86: Murmur algorithm version 3: 128-bit hash result optimized for 32-bit processors
Not available.
Versions 24 and later
HA_MURMUR_3_128_X64: Murmur algorithm version 3: 128-bit hash result optimized for 64-bit processors
Not available.
New in version 24
HA_MURMUR_3_128_X64: Murmur algorithm version 3: 128-bit hash result optimized for 64-bit processors
Not available.
HA_MURMUR_3_128_X64: Murmur algorithm version 3: 128-bit hash result optimized for 64-bit processors
Not available.
SHA family HA_HMAC_SHA_160
HA_HMAC_SHA_256
HA_HMAC_SHA_384
HA_HMAC_SHA_512
Versions 23 and later
SHA-3 family
New in version 23
SHA-3 family
SHA-3 family
Versions 23 and later
HA_SHA3_224
Not available.
New in version 23
HA_SHA3_224
Not available.
HA_SHA3_224
Not available.
Versions 23 and later
HA_SHA3_256
Not available.
New in version 23
HA_SHA3_256
Not available.
HA_SHA3_256
Not available.
Versions 23 and later
HA_SHA3_384
Not available.
New in version 23
HA_SHA3_384
Not available.
HA_SHA3_384
Not available.
Versions 23 and later
HA_SHA3_512
Not available.
New in version 23
HA_SHA3_512
Not available.
HA_SHA3_512
Not available.
RIPEMD family HA_HMAC_RIPEMD_128
Not available.
HA_HMAC_RIPEMD_160
Not available.
TIGER family HA_HMAC_TIGER_128
Not available.
Not available.
HA_HMAC_TIGER_160
Not available.
Not available.
HA_HMAC_TIGER_192
Not available.
Not available.
WHIRLPOOL family HA_HMAC_WHIRLPOOL
Not available.
MD5/SHA/RIPEMD algorithms: standard cryptographic hash functions.
TIGER/WHIRLPOOL algorithms: hash functions with high cryptographic properties optimized for the 64-bit mode (but can also be used in 32-bit mode).
The TIGER algorithms are not available.
Versions 24 and later
MURMUR algorithm: very fast hashing functions. This algorithm is used by the "bloom filter" of bitcoin wallets.
New in version 24
MURMUR algorithm: very fast hashing functions. This algorithm is used by the "bloom filter" of bitcoin wallets.
MURMUR algorithm: very fast hashing functions. This algorithm is used by the "bloom filter" of bitcoin wallets.

<String>: Character string (with quotes)

String for which the Hash will be checked.

<Hash>: Character string (with quotes)

Hash of string to check. This Hash must be the result of HashString previously called for <String> on <Type of algorithm>.

<Secret key>: Character string (between quotes) or Integer

Authentication key of message. This key must be identical to the one used to calculate the Hash.
This parameter must not be an empty string.

Remarks

Availability of algorithms

The available algorithms depend on the configuration of PHP server.

The TIGER algorithms are not available.The SHA-3 algorithms are not available.

Only the following algorithms are supported:

HA_MD5_128
HA_SHA_160, HA_SHA_256, HA_SHA_384, HA_SHA_512
HA_HMAC_MD5_128
HA_HMAC_SHA_160, HA_HMAC_SHA_256, HA_HMAC_SHA_384, HA_SHA_HMAC_512.

HashCheckString function and UNICODE

Multi-platform development: To use Hash of strings between several platforms (a hash generated in iOS and checked in Android or Windows for example), no Unicode string must be used. Indeed, the Unicode strings do not have the same format according to the platforms. In this case, we advise you to use strings in ANSI or UTF 8 format (and to convert the Unicode strings if necessary).

Component : wd240com.dll