CStringT::operator <=

Artikel
12/17/2007

Determines whether the string on the left side of the operator is less than or equal to the string on the right side.

friend bool operator<=(
   const CStringT& str1,
   const CStringT& str2
) throw();
friend bool operator<=(
   const CStringT& str1
   PCXSTR psz2
) throw();
friend bool operator<=(
   PCXSTR psz1
   const CStringT& str2
) throw();

Parameters

str1
A CStringT for comparison.
str2
A CStringT for comparison.
psz1
A pointer to a null-terminated string for comparison.
psz2
A pointer to a null-terminated string for comparison.

Remarks

A lexicographical comparison between strings, character by character until:

It finds two corresponding characters unequal, and the result of their comparison is taken as the result of the comparison between the strings.
It finds no inequalities, but one string has more characters than the other, and the shorter string is considered less than the longer string.
It finds no inequalities and finds that the strings have the same number of characters, so the strings are equal.

Example

// typedef CStringT<TCHAR, StrTraitATL<TCHAR, ChTraitsCRT<TCHAR>>> CAtlString;
CAtlString s1(_T("cat")), s2(_T("cats")), s3(_T("dogs"));

ASSERT(s1 <= _T("dog"));
ASSERT(s1 <= _T("cat"));
ASSERT(s3 <= _T("dogs and cats"));
ASSERT(s2 <= s3);

Requirements

Header: cstringt.h

See Also

Concepts

CStringT Members