[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


   NAME
        Strnicmp -- length-limited case-insensitive string compare. (V37)

   SYNOPSIS
        result = Strnicmp(string1,string2,length);
        D0                A0      A1      D0

        long strnicmp(strptr,strptr,long);

   FUNCTION
        This function compares two strings, ignoring case using a generic
        case conversion routine. If the strings have different lengths,
        the shorter is treated as if it were extended with zeros. This function
        never compares more than 'length' characters.

   INPUTS
        string1, string2 - strings to be compared
        length - maximum number of characters to examine

   RESULTS
        result - relationship between string1 and string2
                        <0 means string1 < string2
                        =0 means string1 = string2
                        >0 means string1 > string2

   NOTES
        Whenever locale.library is installed in a system, this function is
        replaced by language-specific code. This means that depending on
        which language the user has currently selected, identical pairs of
        strings may return different values when passed to this function.
        This fact must be taken into consideration when using this function.

   SEE ALSO
        stricmp(), locale.library/strncmp()