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

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 _KEY_H_
  36. #define _KEY_H_
  37. #include "hxtypes.h"
  38. #include "hxresult.h"
  39. /*
  40.  *  Class Name:   Key
  41.  *  Description:
  42.  *   key strings for the log database. has the property of being
  43.  *  hierarchical, i.e. the keys can be,
  44.  *  "server" -- can or cannot contain other elements
  45.  *  "server.foo" -- "server" contains "foo"
  46.  *  "server.foo.bar" -- "server.foo" contains "bar"
  47.  */
  48. class Key
  49. {
  50. private:
  51.     char*   _key_str;
  52.     const char* _curr_ptr;
  53.     int _curr_level;
  54.     char* _last_sub_str;
  55.     char    _delim;
  56.     int     _size;
  57.     int _num_levels;
  58.     char** _sub_strs;
  59. public:
  60.          Key(const Key & k) {}
  61.          Key(const char* str, char delim = '.');
  62.          ~Key();
  63.     char* get_key_str() const;
  64.     int get_sub_str(char* buf, int len, char delim = '');
  65.     int append_sub_str(char* buf, int buf_len, char delim = '');
  66.     BOOL last_sub_str();
  67.     BOOL is_a_sub_str_of(char* str) const;
  68.     int size() { return _size; }
  69.     char delim() { return _delim; }
  70.     int num_levels() { return _num_levels; }
  71.     void reset();
  72.     HX_RESULT   m_LastError;
  73. };
  74. inline
  75. Key::~Key()
  76. {
  77.     delete [] _key_str;
  78.     delete [] _sub_strs;
  79. }
  80. /*
  81.  *  Function Name:   Key::get_key_str const
  82.  *  Input Params:   
  83.  *  Return Value:    inline char *
  84.  *  Description:
  85.  *   returns a pointer to the entire key string.
  86.  */
  87. inline char *
  88. Key::get_key_str() const
  89. {
  90.     return _key_str;
  91. }
  92. /*
  93.  *  Function Name:   Key::reset
  94.  *  Input Params:   
  95.  *  Return Value:    void
  96.  *  Description:
  97.  *   resets the "curr_ptr" pointer to the begining of the "key_str".
  98.  *  this is used in case someone wants to get the sub-strings of "key_str"
  99.  *  again.
  100.  */
  101. inline void
  102. Key::reset()
  103. {
  104.     _curr_ptr = _key_str;
  105.     _curr_level = 0;
  106. }
  107. inline BOOL
  108. Key::last_sub_str()
  109. {
  110.     return (_curr_ptr >= _last_sub_str) ? TRUE : FALSE;
  111. }
  112. #endif // _KEY_H_