Str_Cmp()
Determines if two strings are identical.
Files
lib_str.h/lib_str.c
Prototype
CPU_INT16S Str_Cmp (const CPU_CHAR *p1_str, const CPU_CHAR *p2_str);
Arguments
p1_str
Pointer to the first string.
p2_str
Pointer to the second string.
Returned Value
Zero value,
if strings are identical; i.e., both strings are identical for the specified length of characters.
Positive value,
if p1_str
is greater than p2_str
; i.e., p1_str
points to a character of higher value than p2_str
for the first non-matching character found.
Negative value,
if p1_str
is less than p2_str
; i.e., p1_str
points to a character of lesser value than p2_str
for the first non-matching character found.
Required Configuration
None.
Notes / Warnings
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_Cmp("Hello World!", "Hello World.");