Str_CmpIgnoreCase_N()

Determines if two strings are identical for up to a specified length of characters, ignoring case.

Files

lib_str.h/lib_str.c

Prototype

          CPU_INT16S  Str_CmpIgnoreCase_N (const  CPU_CHAR    *p1_str,
                                           const  CPU_CHAR    *p2_str,
                                                  CPU_SIZE_T   len_max);

Arguments

p1_str

Pointer to the first string.

p2_str

Pointer to the second string.

len_max

Maximum number of string characters to compare.

Returned Value

Zero value,

if strings are identical (ignoring case); i.e., both strings are identical (ignoring case) for the specified length of characters.

Positive value,

if p1_str is greater than p2_str, ignoring case; i.e., p1_str points to a character (when converted to lower case) of higher value than p2_str for the first non-matching character found.

Negative value,

if p1_str is less than p2_str, ignoring case; i.e., p1_str points to a character (when converted to lower case) of lesser value than p2_str for the first non-matching character found.

Required Configuration

None.

Notes / Warnings

Str_CmpIgnoreCase_N() behaves as if the two strings were converted to lower case and then compared with Str_Cmp_N().

String buffers not modified.

String comparison terminates if either string pointer points to or overlaps the NULL address.

Since 16-bit signed arithmetic is performed to calculate a non-identical comparison return value, CPU_CHAR native data type size must be 8-bit.

Example Usage

          CPU_INT16S  cmp;


          cmp = Str_CmpIgnoreCase_N("Hello World!", "hElLo WoRlD.", 11u);