CSimpleStringT::CSimpleStringT

Constructs a CSimpleStringT object.

CSimpleStringT( 
   const XCHAR* pchSrc, 
   int nLength, 
   IAtlStringMgr* pStringMgr 
); 
CSimpleStringT( 
   PCXSTR pszSrc, 
   IAtlStringMgr* pStringMgr 
); 
CSimpleStringT( 
   const CSimpleStringT& strSrc  
); 
explicit CSimpleStringT( 
   IAtlStringMgr* pStringMgr 
) throw( );

Parameters

  • strSrc
    An existing CSimpleStringT object to be copied into this CSimpleStringT object.

  • pchSrc
    A pointer to an array of characters of length nLength, not null terminated.

  • pszSrc
    A null-terminated string to be copied into this CSimpleStringT object.

  • nLength
    A count of the number of characters in pch.

  • pStringMgr
    A pointer to the memory manager of the CSimpleStringT object. For more information about IAtlStringMgr and memory management for CSimpleStringT, see Memory Management with CStringT.

Remarks

Construct a new CSimpleStringT object. Because the constructors copy the input data into new allocated storage, memory exceptions may result.

Example

The following example demonstrates CSimpleStringT::CSimpleStringT by using the ATL typedefCSimpleString. CSimpleString is a commonly used specialization of the class template CSimpleStringT.

A specialization defines a class by putting specific type parameters into a class template. For more information, see Class Template Instantiation.

CSimpleString s1(pMgr);                   // Empty string
CSimpleString s2(_T("cat"), pMgr);        // From a C string literal

CSimpleString s3(s2);                     // Copy constructor
CSimpleString s4(s2 + _T(" ") + s3);      // From a string expression

CSimpleString s5(_T("xxxxxx"), 6, pMgr);  // s5 = "xxxxxx"

Requirements

Header: atlsimpstr.h

See Also

Reference

CSimpleStringT Class

Other Resources

CSimpleStringT Members

Change History

Date

History

Reason

October 2009

Added a description of CSimpleStringT as a class template and CSimpleString as a typedef.

Customer feedback.