ParsePair.hxx
上传用户:sy_wanhua
上传日期:2013-07-25
资源大小:3048k
文件大小:6k
源码类别:

流媒体/Mpeg4/MP4

开发平台:

C/C++

  1. #if !defined(VOCAL_PARSEPAIR_HXX)
  2. #define VOCAL_PARSEPAIR_HXX
  3. /* ====================================================================
  4.  * The Vovida Software License, Version 1.0 
  5.  * 
  6.  * Copyright (c) 2000 Vovida Networks, Inc.  All rights reserved.
  7.  * 
  8.  * Redistribution and use in source and binary forms, with or without
  9.  * modification, are permitted provided that the following conditions
  10.  * are met:
  11.  * 
  12.  * 1. Redistributions of source code must retain the above copyright
  13.  *    notice, this list of conditions and the following disclaimer.
  14.  * 
  15.  * 2. Redistributions in binary form must reproduce the above copyright
  16.  *    notice, this list of conditions and the following disclaimer in
  17.  *    the documentation and/or other materials provided with the
  18.  *    distribution.
  19.  * 
  20.  * 3. The names "VOCAL", "Vovida Open Communication Application Library",
  21.  *    and "Vovida Open Communication Application Library (VOCAL)" must
  22.  *    not be used to endorse or promote products derived from this
  23.  *    software without prior written permission. For written
  24.  *    permission, please contact vocal@vovida.org.
  25.  *
  26.  * 4. Products derived from this software may not be called "VOCAL", nor
  27.  *    may "VOCAL" appear in their name, without prior written
  28.  *    permission of Vovida Networks, Inc.
  29.  * 
  30.  * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED
  31.  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  32.  * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND
  33.  * NON-INFRINGEMENT ARE DISCLAIMED.  IN NO EVENT SHALL VOVIDA
  34.  * NETWORKS, INC. OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT DAMAGES
  35.  * IN EXCESS OF $1,000, NOR FOR ANY INDIRECT, INCIDENTAL, SPECIAL,
  36.  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  37.  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  38.  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
  39.  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  40.  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
  41.  * USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
  42.  * DAMAGE.
  43.  * 
  44.  * ====================================================================
  45.  * 
  46.  * This software consists of voluntary contributions made by Vovida
  47.  * Networks, Inc. and many individuals on behalf of Vovida Networks,
  48.  * Inc.  For more information on Vovida Networks, Inc., please see
  49.  * <http://www.vovida.org/>.
  50.  *
  51.  */
  52. static const char* const ParsePair_hxx_Version =
  53.     "$Id: ParsePair.hxx,v 1.5 2001/04/13 06:30:20 icahoon Exp $";
  54. #include "VocalCommon.hxx"
  55. #include "NonCopyable.hxx"
  56. #include "NameValue.hxx"
  57. #include "parser.h"
  58. #include <string>
  59. #include <iostream>
  60. /** Vovida Open Communication Application Library.<br><br>
  61.  */
  62. namespace Vocal 
  63. {
  64. /** 
  65.  */
  66. namespace Configuration
  67. {
  68. using std::string;
  69. using std::istream;
  70. class ParsePair : Vocal::NonCopyable
  71. {
  72.     public:
  73.         static const size_t MAX_LINE_LENGTH;
  74.         static const size_t MAX_NAME_LENGTH;
  75.         static const size_t MAX_VALUE_LENGTH;
  76.         static const string SEPARATORS;
  77.         
  78.         static const string COMMENT_CHARS;
  79.         
  80.         ParsePair();
  81.         
  82.         virtual ~ParsePair();
  83.         
  84.         void                    tagName(const string &);
  85.         
  86.         enum Type
  87.         {
  88.             CFG_FILE,
  89.             CFG_STRING,
  90.             CFG_XML_FILE,
  91.             CFG_XML_STRING
  92.         };
  93.         
  94.         /** If type is CFG_FILE, the file will be opened and parsed.
  95.          *  If the file extension is ".xml", it will be parsed as an
  96.          *  XML file. Otherwise is will be parse as name value pairs.
  97.          *  The name and value must be on a single line. The first
  98.          *  word is parsed as the name, and the rest as the value.
  99.          *  You may have one or more separation characters between the
  100.          *  name and value. The separation characters are ":=;,\/ t".
  101.          *  You may also include single line comments in the file. A 
  102.          *  comment starts with one of the comment characters "#!".
  103.          *  A line with a name value pair may have a comment on following
  104.          *  the value.<br><br>
  105.          *
  106.          *  If type is CFG_STRING, the string will be parse similar to
  107.          *  a text file.<br><br>
  108.          *
  109.          *  If type is CFG_XML_FILE, the file will be opened and parsed
  110.          *  as an XML file. The general format is:
  111.          *  <pre>
  112.          *  &lt;myTagName&rt;
  113.          *      &lt;name&rt;value&lt;/name&rt;  &lt;!- name value pair -&rt;
  114.          *      &lt;name/&rt;             &lt;!- no value
  115.          *      ...
  116.          *  &lt;myTagName&rt;
  117.          *  </pre><br><br>
  118.          *
  119.          *  If type is CFG_XML_STRING, the string will be parsed as XML.
  120.          *  <br><br>
  121.          *
  122.          *  Calling parse multiple times will add entries to the name 
  123.          *  value map.<br><br>
  124.          */
  125.         ReturnCode              parse(Type, const string &);
  126.         /** Returns the name value map that is populated as a result of
  127.          *  calling parse.
  128.          */
  129.         const NameValueMap &    pairs() const;
  130.         
  131.     private:
  132.         ReturnCode          parseFile();
  133.         ReturnCode          parseStream(istream &);
  134.         ReturnCode          parseXMLFile();
  135.         ReturnCode          parseXMLString(const string &);
  136.         ReturnCode          parseXML(xmlDocPtr &);
  137.         void                removeWS(string &);
  138.         void                removeLeadingWS(string &);
  139.         void                removeTrailingWS(string &);
  140.         string              myTagName;
  141.                 
  142.         string              myFileName;
  143.         NameValueMap        myPairs;
  144. };
  145. } // namespace Configuration
  146. } // namespace Vocal
  147. #endif // !defined(VOCAL_PARSEPAIR_HXX)