wcsncmp

Description of the 'wcsncmp' function in HyperDbg Scripts

Function

wcsncmp

Syntax

wcsncmp( WStr1, WStr2, Num );

Parameters

[WStr1]

A MASM-like expression or a wide-character string to compare with WStr2.

[WStr2]

A MASM-like expression or a wide-character string to compare with WStr1.

[Num]

Maximum number of characters to compare.

Description

Compares up to Num characters of the wide-character string WStr1 to the wide-character string WStr2.

If the characters are equal, the comparison continues with the next pair of characters. This process repeats until the characters differ, a terminating null character is encountered, or Num characters have been compared in both strings, whichever occurs first.

Wide-character strings are started with an L character before the quotations. For example L"This is a wide-character string".

Return value

Returns an integer value indicating the relationship between the strings:

Return Value
Indicates

<0

The first wide-character that does not match has a lower value in WStr1 than in WStr2.

0

The contents of both wide-character strings are equal.

>0

The first wide-character that does not match has a greater value in WStr1 than in WStr2.

Examples

wcsncmp(fffff806`6de00000, @rax+c0, 0n12);

Compare the the first 12 (decimal) characters of the wide-character string located at fffff806`6de00000 with the wide-character string located at @rax+c0.

wcsncmp(@rcx, L"Test WString", 12);

Compare the first 0x12 (hexadecimal) characters of the wide-character string located at @rcx with the wide-character string L"Test WString".

wcsncmp(L"Test WString1", L"Test WString2", 0n10);

Compare the first 10 (decimal) characters of the wide-character string L"Test WString1" with the wide-character string L"Test WString2".

Remarks

This function checks for the validity of both the source and the destination address before the comparison.

The support for this function is added from v0.9.

strcmp

strncmp

memcmp

Last updated