CStringT::operator <=

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

Reference

CStringT Class