2.1.2.49 strcmp

1 Description
2 Syntax
3 Parameters
4 Return
5 Examples
6 Remark
7 See Also
8 Header to Include
9 Reference

Description

Compare strings.

Syntax

int strcmp( LPCSTR lpString1, LPCSTR lpString2 )

Parameters

lpString1: [input] Pointer to the first null-terminated string to be compared.
lpString2: [input] Pointer to the second null-terminated string to be compared.

Return

If the string pointed to by lpString1 is less than the string pointed to by lpString2, the return value is negative.

If the string pointed to by lpString1 is greater than the string pointed to by lpString2, the return value is positive.

If the strings are equal, the return value is zero.

Examples

EX1

void strcmp_ex1()
{
    string    str1 = "Hello World!";
    int     cmp = strcmp(str1, "HELLO WORLD!");    // cmp equals 1.
    out_int("cmp = ", cmp);
}