Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

CA2AEX Class 

This class is used by the string conversion macros CA2TEX and CT2AEX, and the typedef CA2A.


template<
   int t_nBufferLength = 128
>
class CA2AEX

Parameters

t_nBufferLength

The size of the buffer used in the translation process. The default length is 128 bytes.

Unless extra functionality is required, use CA2TEX, CT2AEX, or CA2A in your own code.

This class contains a fixed-size static buffer which is used to store the result of the conversion. If the result is too large to fit into the static buffer, the class allocates memory using malloc, freeing the memory when the object goes out of scope. This ensures that, unlike text conversion macros available in previous versions of ATL, this class is safe to use in loops and that it won't overflow the stack.

If the class tries to allocate memory on the heap and fails, it will call AtlThrow with an argument of E_OUTOFMEMORY.

By default, the ATL conversion classes and macros use the current thread's ANSI code page for the conversion.

The following macros are based on this class:

  • CA2TEX

  • CT2AEX

The following typedef is based on this class:

  • CA2A

For a discussion of these text conversion macros, see ATL and MFC String Conversion Macros.

See ATL and MFC String Conversion Macros for an example of using these string conversion macros.

Header: atlconv.h

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.