<< Previous | Next >>

strcmpi

NEAR SYNTAX: int * _n_strcmpi( char * str1, char * str2 );

FAR SYNTAX: int _f_strcmpi( char far * str1, char far * str2 );

NOTE	By default, strcmpi() is defined to _n_strcmpi().

Description

Performs case-insensitive unsigned character by character comparison of two null terminated strings.

For Rabbit 4000+ users, this function supports FAR pointers. By default the near version of the function is called. The macro USE_FAR_STRING will change all calls to functions in this library to their far versions. The user may also explicitly call the far version with _f_strfunc where strfunc is the name of the string function.

Because FAR addresses are larger, the far versions of this function will run slightly slower than the near version. To explicitly call the near version when the USE_FAR_STRING macro is defined and all pointers are near pointers, append _n_ to the function name, e.g., _n_strfunc. For more information about FAR pointers, see the Dynamic C User's Manual or the samples in Samples/Rabbit4000/FAR/.

Parameters

str1

Pointer to string 1.

str2

Pointer to string 2.

Return value

<0: str1 is less than str2 because
character in str1 is less than corresponding character in str2, or
str1 is shorter than but otherwise identical to str2.

=0: str1 is identical to str2

>0: str1 is greater than str2 because
character in str1 is greater than corresponding character in str2, or
str2 is shorter than but otherwise identical to str1.

Library

STRING.LIB

See also

strncmpi, strncmp, strcmp