Trims leading and trailing characters from the string.

CStringT& Trim(
   XCHAR chTarget 
CStringT& Trim(
   PCXSTR pszTargets 
CStringT& Trim( );


The target character to be trimmed.


A pointer to a string containing the target characters to be trimmed. All leading and trailing occurrences of characters in pszTarget will be trimmed from the CStringT object.

Returns the trimmed string.

Removes all leading and trailing occurrences of one of the following:

  • The character specified by chTarget.

  • All characters found in the string specified by pszTargets.

  • Whitespace.

// typedef CStringT<TCHAR, StrTraitATL<TCHAR, ChTraitsCRT<TCHAR>>> CAtlString;

CAtlString str;
str = _T("******Soccer is best!?!?!?!?!");

_tprintf_s(_T("Before: \"%s\"\n"), (LPCTSTR)str);
_tprintf_s(_T("After : \"%s\"\n"), (LPCTSTR)str.Trim(_T("?!*")));

// Output: 
// -------------------------- 
// Before: ******Soccer is best!?!?!?!?! 
// After: Soccer is best

The output from this example is as follows:

Before: "******Soccer is best, but liquor is quicker!?!?!?!?!"

After : "Soccer is best, but liquor is quicker"

Header: cstringt.h