_stricmp, _wcsicmp (Windows CE 5.0)
Developing an Application > Microsoft C Run-time Library for Windows CE > Run-time Library Reference
Perform a lowercase comparison of strings.
int _stricmp( const char *string1, const char *string2 );int _wcsicmp( const wchar_t *string1, constwchar_t *string2);
Parameters
- string1, string2
Null-terminated strings to compare.
Return Values
The return value indicates the relation of string1 to string2 as follows.
| Return Value | Description |
|---|---|
| < 0 | string1 less than string2 |
| 0 | string1 identical to string2 |
| > 0 | string1 greater than string2 |
Remarks
These functions are supported by all versions of the C run-time libraries.
The _stricmp function lexicographically compares lowercase versions of string1 and string2 and returns a value indicating their relationship. _stricmp differs from _stricoll in that the _stricmp comparison is affected by LC_CTYPE, whereas the _stricoll comparison is according to the LC_CTYPE and LC_COLLATE categories of the current locale.
Because _wcsicmp does lowercase comparisons, it can result in unexpected behavior.
_wcsicmp is a wide-character version of _stricmp. The arguments and return value of _wcsicmp are wide-character strings. These two functions behave identically otherwise.
_stricmp and strcmp behave identically except that strcmp does not convert its arguments to lowercase before comparing them.
The following table shows generic-text routine mappings for this function.
| TCHAR.H Routine | _UNICODE Defined |
|---|---|
| _tcsicmp | _wcsicmp |
For more information about TCHAR.H routines, see Generic Text Mappings.
Requirements
OS Versions: Windows CE 2.0 and later.
Header: stdio.h, string.h.
Link Library: coredll.dll.
See Also
memcmp | _memicmp | strcmp | strncmp
Send Feedback on this topic to the authors