Namespaces
Variants
Views
Actions

std::strcmp

From cppreference.com
< cpp‎ | string‎ | byte
Revision as of 23:25, 31 May 2013 by P12bot (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Defined in header <cstring>
int strcmp( const char *lhs, const char *rhs );

Compares two null-terminated byte strings. The comparison is done lexicographically.

Both lhs and rhs should point to valid strings.

Contents

[edit] Parameters

lhs, rhs - pointers to the null-terminated byte strings to compare

[edit] Return value

Negative value if lhs is less than rhs.

0 if lhs is equal to rhs.

Positive value if lhs is greater than rhs.

[edit] Example

#include <vector>
#include <cstring>
#include <algorithm>
#include <iostream>
 
int main() 
{
    std::vector<const char*> cats {"Heathcliff", "Snagglepuss", "Hobbes", "Garfield"};
    std::sort(cats.begin(), cats.end(), [](const char *strA, const char *strB) {
        return std::strcmp(strA, strB) < 0;
    }); 
 
    for (const char *cat : cats) {
        std::cout << cat << '\n';
    }
}

Output:

Garfield
Heathcliff
Hobbes
Snagglepuss

[edit] See also

compares a certain amount of characters of two strings
(function) [edit]
compares two buffers
(function) [edit]
compares two strings in accordance to the current locale
(function) [edit]
C documentation for strcmp