key.h
上传用户:dangjiwu
上传日期:2013-07-19
资源大小:42019k
文件大小:4k
源码类别:

Symbian

开发平台:

Visual C++

  1. /* ***** BEGIN LICENSE BLOCK *****
  2.  * Source last modified: $Id: key.h,v 1.2.32.3 2004/07/09 01:48:00 hubbe Exp $
  3.  * 
  4.  * Portions Copyright (c) 1995-2004 RealNetworks, Inc. All Rights Reserved.
  5.  * 
  6.  * The contents of this file, and the files included with this file,
  7.  * are subject to the current version of the RealNetworks Public
  8.  * Source License (the "RPSL") available at
  9.  * http://www.helixcommunity.org/content/rpsl unless you have licensed
  10.  * the file under the current version of the RealNetworks Community
  11.  * Source License (the "RCSL") available at
  12.  * http://www.helixcommunity.org/content/rcsl, in which case the RCSL
  13.  * will apply. You may also obtain the license terms directly from
  14.  * RealNetworks.  You may not use this file except in compliance with
  15.  * the RPSL or, if you have a valid RCSL with RealNetworks applicable
  16.  * to this file, the RCSL.  Please see the applicable RPSL or RCSL for
  17.  * the rights, obligations and limitations governing use of the
  18.  * contents of the file.
  19.  * 
  20.  * Alternatively, the contents of this file may be used under the
  21.  * terms of the GNU General Public License Version 2 or later (the
  22.  * "GPL") in which case the provisions of the GPL are applicable
  23.  * instead of those above. If you wish to allow use of your version of
  24.  * this file only under the terms of the GPL, and not to allow others
  25.  * to use your version of this file under the terms of either the RPSL
  26.  * or RCSL, indicate your decision by deleting the provisions above
  27.  * and replace them with the notice and other provisions required by
  28.  * the GPL. If you do not delete the provisions above, a recipient may
  29.  * use your version of this file under the terms of any one of the
  30.  * RPSL, the RCSL or the GPL.
  31.  * 
  32.  * This file is part of the Helix DNA Technology. RealNetworks is the
  33.  * developer of the Original Code and owns the copyrights in the
  34.  * portions it created.
  35.  * 
  36.  * This file, and the files included with this file, is distributed
  37.  * and made available on an 'AS IS' basis, WITHOUT WARRANTY OF ANY
  38.  * KIND, EITHER EXPRESS OR IMPLIED, AND REALNETWORKS HEREBY DISCLAIMS
  39.  * ALL SUCH WARRANTIES, INCLUDING WITHOUT LIMITATION, ANY WARRANTIES
  40.  * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, QUIET
  41.  * ENJOYMENT OR NON-INFRINGEMENT.
  42.  * 
  43.  * Technology Compatibility Kit Test Suite(s) Location:
  44.  *    http://www.helixcommunity.org/content/tck
  45.  * 
  46.  * Contributor(s):
  47.  * 
  48.  * ***** END LICENSE BLOCK ***** */
  49. #ifndef _KEY_H_
  50. #define _KEY_H_
  51. #include "hxtypes.h"
  52. #include "hxresult.h"
  53. /*
  54.  *  Class Name:   Key
  55.  *  Description:
  56.  *   key strings for the log database. has the property of being
  57.  *  hierarchical, i.e. the keys can be,
  58.  *  "server" -- can or cannot contain other elements
  59.  *  "server.foo" -- "server" contains "foo"
  60.  *  "server.foo.bar" -- "server.foo" contains "bar"
  61.  */
  62. class Key
  63. {
  64. private:
  65.     char*   _key_str;
  66.     const char* _curr_ptr;
  67.     int _curr_level;
  68.     char* _last_sub_str;
  69.     char    _delim;
  70.     int     _size;
  71.     int _num_levels;
  72.     char** _sub_strs;
  73. public:
  74.          Key(const Key & k) {}
  75.          Key(const char* str, char delim = '.');
  76.          ~Key();
  77.     char* get_key_str() const;
  78.     int get_sub_str(char* buf, int len, char delim = '');
  79.     int append_sub_str(char* buf, int buf_len, char delim = '');
  80.     BOOL last_sub_str();
  81.     BOOL is_a_sub_str_of(char* str) const;
  82.     int size() { return _size; }
  83.     char delim() { return _delim; }
  84.     int num_levels() { return _num_levels; }
  85.     void reset();
  86.     HX_RESULT   m_LastError;
  87. };
  88. inline
  89. Key::~Key()
  90. {
  91.     delete [] _key_str;
  92.     delete [] _sub_strs;
  93. }
  94. /*
  95.  *  Function Name:   Key::get_key_str const
  96.  *  Input Params:   
  97.  *  Return Value:    inline char *
  98.  *  Description:
  99.  *   returns a pointer to the entire key string.
  100.  */
  101. inline char *
  102. Key::get_key_str() const
  103. {
  104.     return _key_str;
  105. }
  106. /*
  107.  *  Function Name:   Key::reset
  108.  *  Input Params:   
  109.  *  Return Value:    void
  110.  *  Description:
  111.  *   resets the "curr_ptr" pointer to the begining of the "key_str".
  112.  *  this is used in case someone wants to get the sub-strings of "key_str"
  113.  *  again.
  114.  */
  115. inline void
  116. Key::reset()
  117. {
  118.     _curr_ptr = _key_str;
  119.     _curr_level = 0;
  120. }
  121. inline BOOL
  122. Key::last_sub_str()
  123. {
  124.     return (_curr_ptr >= _last_sub_str) ? TRUE : FALSE;
  125. }
  126. #endif // _KEY_H_