docs/doxygen/overviews/bufferclasses.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        bufferclasses.h
   3 // Purpose:     topic overview
   4 // Author:      wxWidgets team
   5 // RCS-ID:      $Id$
   6 // Licence:     wxWindows license
   7 /////////////////////////////////////////////////////////////////////////////
   8
   9 /*!
  10
  11  @page overview_bufferclasses Buffer classes overview
  12
  13  wxWidgets uses two classes of classes for dealing with buffers in memory.
  14
  15  The first is one for dealing with character buffers, namely wxCharBuffer
  16  for char pointer or multi-byte c strings and wxWCharBuffer for wchar_t pointer
  17  or wide character c strings.
  18
  19  Secondly, wxWidgets uses, although only rarely currently, wxMemoryBuffer
  20  for dealing with raw buffers in memory.
  21
  22  @li @ref overview_bufferclasses_wxcb
  23
  24
  25  <hr>
  26
  27
  28  @section overview_bufferclasses_wxcb wxXCharBuffer Overview
  29
  30  @b General Usage
  31  As mentioned, wxCharBuffer and its wide character variant wxWCharBuffer deal
  32  with c strings in memory.  They have two constructors, one in which you pass
  33  the c string you want them to have a copy of, and another where you specify
  34  the size of the buffer in memory in characters you want.
  35
  36  wxCharBuffer and its variant only contain the c string as a member, so they
  37  can be used safely to c functions with variable arguments such as printf.
  38  They also contain standard assignment, character access operators and a copy constructor.
  39
  40  @b Destruction
  41  It should be noted that on destruction wxCharBuffer and its wide character
  42  variant delete the c string that hold onto.  If you want to get the pointer
  43  to the buffer and don't want wxCharBuffer to delete it on destruction,
  44  use the member function release to do so.
  45
  46 */
  47