Merge branch 'debian/sid' into debian/experimental

[apt.git] / apt-pkg / contrib / configuration.h

diff --git a/apt-pkg/contrib/configuration.h b/apt-pkg/contrib/configuration.h
index 84a8cf07ea3482774dbf93c32a612039ea7d961d..6345c8a5d5efdf107476500e79fcfee05599905f 100644 (file)
--- a/apt-pkg/contrib/configuration.h
+++ b/apt-pkg/contrib/configuration.h
@@ -1,6 +1,6 @@
 // -*- mode: cpp; mode: fold -*-
 // Description                                                         /*{{{*/
 // -*- mode: cpp; mode: fold -*-
 // Description                                                         /*{{{*/

-// $Id: configuration.h,v 1.13 2001/03/11 07:22:19 jgg Exp $
+// $Id: configuration.h,v 1.16 2002/11/11 06:55:50 doogie Exp $

 /* ######################################################################
 
    Configuration Class
 /* ######################################################################
 
    Configuration Class


@@ -28,11 +28,15 @@
 #ifndef PKGLIB_CONFIGURATION_H
 #define PKGLIB_CONFIGURATION_H
 
 #ifndef PKGLIB_CONFIGURATION_H
 #define PKGLIB_CONFIGURATION_H
 

-#ifdef __GNUG__
-#pragma interface "apt-pkg/configuration.h"
-#endif 
+#include <regex.h>

 
 #include <string>
 
 #include <string>

+#include <vector>
+#include <iostream>
+
+#ifndef APT_8_CLEANER_HEADERS
+using std::string;
+#endif

 
 class Configuration
 {
 
 class Configuration
 {


@@ -40,13 +44,13 @@ class Configuration
    
    struct Item
    {
    
    struct Item
    {

-      string Value;
-      string Tag;
+      std::string Value;
+      std::string Tag;

       Item *Parent;
       Item *Child;
       Item *Next;
       
       Item *Parent;
       Item *Child;
       Item *Next;
       

-      string FullTag(const Item *Stop = 0) const;
+      std::string FullTag(const Item *Stop = 0) const;

       
       Item() : Parent(0), Child(0), Next(0) {};
    };
       
       Item() : Parent(0), Child(0), Next(0) {};
    };


@@ -56,8 +60,8 @@ class Configuration
    Item *Root;
    bool ToFree;
    
    Item *Root;
    bool ToFree;
    

-   Item *Lookup(Item *Head,const char *S,unsigned long Len,bool Create);
-   Item *Lookup(const char *Name,bool Create);   
+   Item *Lookup(Item *Head,const char *S,unsigned long const &Len,bool const &Create);
+   Item *Lookup(const char *Name,const bool &Create);

    inline const Item *Lookup(const char *Name) const
    {
       return ((Configuration *)this)->Lookup(Name,false);
    inline const Item *Lookup(const char *Name) const
    {
       return ((Configuration *)this)->Lookup(Name,false);


@@ -65,42 +69,87 @@ class Configuration
    
    public:
 
    
    public:
 

-   string Find(const char *Name,const char *Default = 0) const;
-   string Find(string Name,const char *Default = 0) const {return Find(Name.c_str(),Default);};
-   string FindFile(const char *Name,const char *Default = 0) const;
-   string FindDir(const char *Name,const char *Default = 0) const;
-   int FindI(const char *Name,int Default = 0) const;
-   int FindI(string Name,int Default = 0) const {return FindI(Name.c_str(),Default);};
-   bool FindB(const char *Name,bool Default = false) const;
-   bool FindB(string Name,bool Default = false) const {return FindB(Name.c_str(),Default);};
-   string FindAny(const char *Name,const char *Default = 0) const;
+   std::string Find(const char *Name,const char *Default = 0) const;
+   std::string Find(std::string const &Name,const char *Default = 0) const {return Find(Name.c_str(),Default);};
+   std::string Find(std::string const &Name, std::string const &Default) const {return Find(Name.c_str(),Default.c_str());};
+   std::string FindFile(const char *Name,const char *Default = 0) const;
+   std::string FindDir(const char *Name,const char *Default = 0) const;
+   /** return a list of child options
+    *
+    * Options like Acquire::Languages are handled as lists which
+    * can be overridden and have a default. For the later two a comma
+    * separated list of values is supported.
+    *
+    * \param Name of the parent node
+    * \param Default list of values separated by commas */
+   std::vector<std::string> FindVector(const char *Name, std::string const &Default) const;
+   std::vector<std::string> FindVector(std::string const &Name, std::string const &Default) const { return FindVector(Name.c_str(), Default); };
+#if (APT_PKG_MAJOR >= 4 && APT_PKG_MINOR < 13)
+   std::vector<std::string> FindVector(const char *Name) const;
+#endif
+   std::vector<std::string> FindVector(std::string const &Name="") const { return FindVector(Name.c_str(), ""); };
+   int FindI(const char *Name,int const &Default = 0) const;
+   int FindI(std::string const &Name,int const &Default = 0) const {return FindI(Name.c_str(),Default);};
+   bool FindB(const char *Name,bool const &Default = false) const;
+   bool FindB(std::string const &Name,bool const &Default = false) const {return FindB(Name.c_str(),Default);};
+   std::string FindAny(const char *Name,const char *Default = 0) const;

              
              

-   inline void Set(string Name,string Value) {Set(Name.c_str(),Value);};
-   void CndSet(const char *Name,string Value);
-   void Set(const char *Name,string Value);
-   void Set(const char *Name,int Value);   
+   inline void Set(const std::string &Name,const std::string &Value) {Set(Name.c_str(),Value);};
+   void CndSet(const char *Name,const std::string &Value);
+   void CndSet(const char *Name,const int Value);
+   void Set(const char *Name,const std::string &Value);
+   void Set(const char *Name,const int &Value);

    
    

-   inline bool Exists(string Name) const {return Exists(Name.c_str());};
+   inline bool Exists(const std::string &Name) const {return Exists(Name.c_str());};

    bool Exists(const char *Name) const;
    bool ExistsAny(const char *Name) const;
 
    bool Exists(const char *Name) const;
    bool ExistsAny(const char *Name) const;
 

-   void Clear(string Name);
-   
+   // clear a whole tree
+   void Clear(const std::string &Name);
+   void Clear();
+
+   // remove a certain value from a list (e.g. the list of "APT::Keep-Fds")
+   void Clear(std::string const &List, std::string const &Value);
+   void Clear(std::string const &List, int const &Value);
+

    inline const Item *Tree(const char *Name) const {return Lookup(Name);};
 
    inline const Item *Tree(const char *Name) const {return Lookup(Name);};
 

-   void Dump();
+   inline void Dump() { Dump(std::clog); };
+   void Dump(std::ostream& str);
+   void Dump(std::ostream& str, char const * const root,
+            char const * const format, bool const emptyValue);

 
    Configuration(const Item *Root);
    Configuration();
    ~Configuration();
 
    Configuration(const Item *Root);
    Configuration();
    ~Configuration();

+
+   /** \brief match a string against a configurable list of patterns */
+   class MatchAgainstConfig
+   {
+     std::vector<regex_t *> patterns;
+     void clearPatterns();
+
+   public:
+     MatchAgainstConfig(char const * Config);
+     virtual ~MatchAgainstConfig();
+
+     /** \brief Returns \b true for a string matching one of the patterns */
+     bool Match(char const * str) const;
+     bool Match(std::string const &str) const { return Match(str.c_str()); };
+
+     /** \brief returns if the matcher setup was successful */
+     bool wasConstructedSuccessfully() const { return patterns.empty() == false; }
+   };

 };
 
 extern Configuration *_config;
 
 };
 
 extern Configuration *_config;
 

-bool ReadConfigFile(Configuration &Conf,string FName,bool AsSectional = false,
-                   unsigned Depth = 0);
+bool ReadConfigFile(Configuration &Conf,const std::string &FName,
+                   bool const &AsSectional = false,
+                   unsigned const &Depth = 0);

 
 

-bool ReadConfigDir(Configuration &Conf,string Dir,bool AsSectional = false,
-                   unsigned Depth = 0);
+bool ReadConfigDir(Configuration &Conf,const std::string &Dir,
+                  bool const &AsSectional = false,
+                  unsigned const &Depth = 0);

 
 #endif
 
 #endif