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

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 _UNIX_PREF
  36. #define _UNIX_PREF
  37. #include "pref.h"
  38. #include <stdio.h>
  39. #define _MAX_KEY  512
  40. struct IHXBuffer;
  41. class CHXSimpleList;
  42. class CHXMapStringToOb;
  43. class CUnixPref : public CPref 
  44. {
  45. public:
  46. /*  call open_pref() to automatically create the correct 
  47. specific preference object. */
  48. /* automatically reads all prefs into memory. */
  49. static CUnixPref*     open_pref (
  50.   const char* pCompanyName
  51. , const char* pProductName
  52. , int nProdMajorVer
  53. , int nProdMinorVer);
  54. /*  class destructor - writes prefs to disk. */
  55. virtual ~CUnixPref  (void);
  56. /*  read_pref reads the preference specified by Key to the Buffer. */
  57.     virtual HX_RESULT read_pref(const char* pPrefKey, IHXBuffer*& pBuffer);
  58.                                                                         
  59. /*  write_pref writes (to memory) the preference specified by Key from the 
  60. Buffer. */                                                                             
  61.     virtual HX_RESULT write_pref(const char* pPrefKey, IHXBuffer* pBuffer);
  62.     /*  delete_pref deletes the preference specified by Key from the Buffer. */                                                                             
  63.     virtual HX_RESULT    delete_pref      (const char* pPrefKey); 
  64.     /* commit_prefs saves all changes to the prefs to disk (e.g. on Unix) */ 
  65.     virtual HX_RESULT commit_prefs();
  66.     virtual HX_RESULT init_pref(
  67.       const char* pCompanyName
  68.     , const char* pProductName
  69.     , int nProdMajorVer
  70.     , int nProdMinorVer);
  71.     /*  remove_indexed_pref removes indexed preference specified by Key */       
  72.     HX_RESULT         remove_indexed_pref(const char* pPrefKey); 
  73.     virtual HX_RESULT remove_pref(const char* pPrefKey);
  74.     HX_RESULT BeginSubPref(const char* szSubPref);
  75.     HX_RESULT EndSubPref();
  76.     HX_RESULT GetPrefKey(UINT32 nIndex,IHXBuffer*& pBuffer);
  77. protected:
  78. // Constructor NOTE: use open_pref() to create an instance of this class
  79. CUnixPref(
  80.   const char* pCompanyName
  81. , const char* pProductName
  82. , int nProdMajorVer
  83. , int nProdMinorVer);
  84.     BOOL            m_bWrite;
  85.     char*     m_pPath;
  86.     int     mFileID;
  87.     FILE*     mFile;
  88.     char            m_RootKeyName[_MAX_KEY]; /* Flawfinder: ignore */
  89.     BOOL            EscapeNewLine(const char* pLine, char*& pOutLine);
  90.     BOOL            UnescapeNewLine(const char* pLine, char*& pOutLine);
  91.     void            ConstructFamily(CHXString &ret);
  92.     void            ConstructPref(const char *pref, CHXString &ret);
  93.     void            ConstructPrefAssignment(const char *pref, const char *pValue,
  94.     CHXString &ret, BOOL bEscapeValue);
  95.     int m_nMajor;
  96.     int m_nMinor;
  97.     CHXString m_pCompany;
  98.     CHXString m_pProduct;
  99. };
  100. #endif // _UNIX_PREF