Click above to get retro games delivered to your door ever month!

Synopsis:
    #include <string.h>
    int _stricoll( const char *s1, const char *s2 );
    #include <wchar.h>
    int _wcsicoll( const wchar_t *s1, const wchar_t *s2 );
    #include <mbstring.h>
    int _mbsicoll( const unsigned char *s1, const unsigned char *s2 );

Description:
    The _stricoll function performs a case insensitive comparison of the
    string pointed to by s1 to the string pointed to by s2.  The comparison
    uses the current code page which can be selected by the  _setmbcp
    function.

    The _wcsicoll function is a wide-character version of _stricoll that
    operates with wide-character strings.

    The _mbsicoll function is a multibyte character version of _stricoll
    that operates with multibyte character strings.

Returns:
    These functions return an integer less than, equal to, or greater than
    zero, indicating that the string pointed to by s1 is less than, equal
    to, or greater than the string pointed to by s2, according to the
    collating sequence selected.  If an error occurs, these functions return
     _NLSCMPERR.  The  _wcsicoll function may set  errno to  EINVAL to
    indicate that either string contains characters outside of the collating
    sequence of the current code page.

Example:
    #include <stdio.h>
    #include <string.h>

    char buffer[80] = "world";

    void main()
      {
        _setmbcp( 932 );
        if( _stricoll( buffer, "Hello" ) < 0 ) {
            printf( "Less than\n" );
        }
      }

Classification:
    WATCOM

Systems:
     _stricoll - All, Netware

    _wcsicoll - All
    _mbsicoll - DOS, Windows, Win386, Win32, OS/2 1.x(all), OS/2-32

See Also:
    _setmbcp, strcoll, stricmp, strncmp, _strncoll, strnicmp, _strnicoll