perplex.h
上传用户:zhongxx05
上传日期:2007-06-06
资源大小:33641k
文件大小:6k
源码类别:

Symbian

开发平台:

C/C++

  1. /* ***** BEGIN LICENSE BLOCK ***** 
  2.  * Version: RCSL 1.0/RPSL 1.0 
  3.  *  
  4.  * Portions Copyright (c) 1995-2002 RealNetworks, Inc. All Rights Reserved. 
  5.  *      
  6.  * The contents of this file, and the files included with this file, are 
  7.  * subject to the current version of the RealNetworks Public Source License 
  8.  * Version 1.0 (the "RPSL") available at 
  9.  * http://www.helixcommunity.org/content/rpsl unless you have licensed 
  10.  * the file under the RealNetworks Community Source License Version 1.0 
  11.  * (the "RCSL") available at http://www.helixcommunity.org/content/rcsl, 
  12.  * in which case the RCSL will apply. You may also obtain the license terms 
  13.  * directly from RealNetworks.  You may not use this file except in 
  14.  * compliance with the RPSL or, if you have a valid RCSL with RealNetworks 
  15.  * applicable to this file, the RCSL.  Please see the applicable RPSL or 
  16.  * RCSL for the rights, obligations and limitations governing use of the 
  17.  * contents of the file.  
  18.  *  
  19.  * This file is part of the Helix DNA Technology. RealNetworks is the 
  20.  * developer of the Original Code and owns the copyrights in the portions 
  21.  * it created. 
  22.  *  
  23.  * This file, and the files included with this file, is distributed and made 
  24.  * available on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER 
  25.  * EXPRESS OR IMPLIED, AND REALNETWORKS HEREBY DISCLAIMS ALL SUCH WARRANTIES, 
  26.  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, FITNESS 
  27.  * FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. 
  28.  * 
  29.  * Technology Compatibility Kit Test Suite(s) Location: 
  30.  *    http://www.helixcommunity.org/content/tck 
  31.  * 
  32.  * Contributor(s): 
  33.  *  
  34.  * ***** END LICENSE BLOCK ***** */ 
  35. #ifndef _HXPERPLEX_H_
  36. #define _HXPERPLEX_H_
  37. //****************************************************************************
  38. //****************************** INCLUDE FILES *******************************
  39. //****************************************************************************
  40. #include "hxtypes.h"
  41. #include "hxstring.h"
  42. #include "timerep.h"
  43. #include "ihxperplex.h"
  44. #include "unkimp.h"
  45. //****************************************************************************
  46. //************************** CONSTANT DEFINITIONS ****************************
  47. //****************************************************************************
  48. #define Perplex_BASE  41
  49. #define Perplex_PER_ULONG32 6
  50. #define Perplex_ALIGNMENT 4
  51. #define DEFAULT_GROW_SIZE 1024 // for dynamic buffer perplex classes
  52. //****************************************************************************
  53. //************************** FORWARD DECLARATIONS ****************************
  54. //****************************************************************************
  55. class CHXPerplex;
  56. class CHXSimpleBuffer; // crappy little buffer class used by CHXInfoEncoder
  57. //****************************************************************************
  58. //****************************** CHXPerplex **********************************
  59. //****************************************************************************
  60. class CHXPerplex : public IHXPerplex, 
  61. public CUnknownIMP
  62. {
  63.     // the IUnknown implementation declaration
  64.     DECLARE_UNKNOWN(CHXPerplex)
  65. public:
  66.     CHXPerplex();
  67.     ~CHXPerplex();
  68.     STDMETHOD(Perplex)     (THIS_ IHXBuffer *pInBuf, IHXBuffer *pOutBuf);
  69.     STDMETHOD(DePerplex)    (THIS_ IHXBuffer *pInBuf, IHXBuffer *pOutBuf);
  70.     // basic routines for hex/perplexing, used when this class doesn't
  71.     // meet your needs.
  72.     static void     DumpToPerplex(char* Perplex, UINT32 ulPerplexSize, UCHAR* Bits, UINT32 nSize);
  73.     static UINT32   SetFromPerplex(const char* Perplex, UCHAR* Bits, UINT32 nSize);
  74. protected:
  75.     static void     DumpToMIMEBase64(char* MIMEBase64, const char* Bits, UINT32 nSize);
  76.     static UINT32   SetFromMIMEBase64(const char* MIMEBase64, char* Bits, UINT32 nSize);
  77.     static char     MapToPerplex(UCHAR Perplex);
  78.     static UCHAR    MapFromPerplex(char Perplex);
  79.     static void     ToPerplex(ULONG32 Input, char* Perplex);
  80.     static ULONG32  FromPerplex(const char* Perplex);
  81.     static char     MapToMIMEBase64(UCHAR MIMEBase64);
  82.     static UCHAR    MapFromMIMEBase64(char MIMEBase64);
  83. };
  84. //****************************************************************************
  85. //**************************** CHXPerplexBuffer ******************************
  86. //****************************************************************************
  87.     // A simple buffer. There is no implicit access/bounds checking,
  88.     // you have to do that yourself or use the 'Safexxxxx()' methods.
  89.     // It's actual size is usually not what you set with resizeBuffer(),
  90.     // since the size will be rounded up to the nearest 'GrowBy' size.
  91. class CHXPerplexBuffer
  92. {
  93. public:
  94.     CHXPerplexBuffer();
  95.     CHXPerplexBuffer(UINT32 nSize, UINT32 nGrowBy=DEFAULT_GROW_SIZE);
  96.     ~CHXPerplexBuffer();
  97.     inline UCHAR* GetPtr()      const { return(m_pData); }
  98.     inline UCHAR* GetPtrAt(UINT32 nOffset)    const { return(m_pData+nOffset); }
  99.     inline UCHAR GetDataAt(UINT32 nOffset)   const { return(*(m_pData+nOffset)); }
  100.     inline UINT32 GetSize()      const { return(m_nSize); }
  101.     inline void SetUCHAR(UINT32 off, UCHAR  x) { *(m_pData+off)=x; }
  102.     inline void SetUINT16(UINT32 off, UINT16 x) { *((UINT16*)(m_pData+off))=x; }
  103.     inline BOOL IsValidOffset(UINT32 n) const;
  104.     // make sure that Offset is within the buffer.
  105.     // If not, the buffer is automatically resized.
  106.     BOOL    EnsureValidOffset(UINT32 n);
  107.     // copy data into buffer, dynamically growing buffer if needed.
  108.     BOOL    SafeMemCopy(UINT32 nOffset, const void* data, UINT32 len);
  109.     // no bounds checking here.
  110.     inline void MemCopy(UINT32 nOffset, const void* data, UINT32 len)
  111.     { 
  112. memcpy(m_pData+nOffset, data, (int)len); /* Flawfinder: ignore */
  113.     }
  114.     // grow/shink buffer (does memcpy)
  115.     BOOL Resize(UINT32 nSize);
  116.     void Free();
  117. protected:
  118.     UINT32 RoundUpToGrowSize(UINT32 nSize);
  119.     UINT32 m_nSize;
  120.     UCHAR* m_pData;
  121.     UINT32 m_nGrowBy;
  122. };
  123. #endif