* doc/examples/configure-index:

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

diff --git a/apt-pkg/contrib/configuration.h b/apt-pkg/contrib/configuration.h
index 9229a0f66248cf40d221efd2f9b5da2518662f84..0d4078dab0144824f90ace28a769b79b1154d61d 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.3 1998/07/12 23:58:45 jgg Exp $
+// $Id: configuration.h,v 1.16 2002/11/11 06:55:50 doogie Exp $

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


@@ -14,13 +14,17 @@
    And has associated with it a text string. The Configuration class only
    provides storage and lookup for this tree, other classes provide
    configuration file formats (and parsers/emitters if needed).
    And has associated with it a text string. The Configuration class only
    provides storage and lookup for this tree, other classes provide
    configuration file formats (and parsers/emitters if needed).

-   
+

    Most things can get by quite happily with,
      cout << _config->Find("Foo::Bar") << endl;
    Most things can get by quite happily with,
      cout << _config->Find("Foo::Bar") << endl;

+
+   A special extension, support for ordered lists is provided by using the
+   special syntax, "block::list::" the trailing :: designates the 
+   item as a list. To access the list you must use the tree function on
+   "block::list".

    
    ##################################################################### */
                                                                        /*}}}*/
    
    ##################################################################### */
                                                                        /*}}}*/

-// Header section: pkglib

 #ifndef PKGLIB_CONFIGURATION_H
 #define PKGLIB_CONFIGURATION_H
 
 #ifndef PKGLIB_CONFIGURATION_H
 #define PKGLIB_CONFIGURATION_H
 


@@ -29,9 +33,14 @@
 #endif 
 
 #include <string>
 #endif 
 
 #include <string>

+#include <iostream>
+
+using std::string;

 
 class Configuration
 {
 
 class Configuration
 {

+   public:
+   

    struct Item
    {
       string Value;
    struct Item
    {
       string Value;


@@ -39,25 +48,70 @@ class Configuration
       Item *Parent;
       Item *Child;
       Item *Next;
       Item *Parent;
       Item *Child;
       Item *Next;

-      Item() : Child(0), Next(0) {};
+      
+      string FullTag(const Item *Stop = 0) const;
+      
+      Item() : Parent(0), Child(0), Next(0) {};

    };
    };

+   
+   private:
+   

    Item *Root;
    Item *Root;

+   bool ToFree;

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

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

    public:
 
    public:
 

-   string Find(const char *Name,const char *Default = 0);
-   string FindDir(const char *Name,const char *Default = 0);
-   int FindI(const char *Name,int Default = 0);
-   
-   void Set(const char *Name,string Value);
-   void Set(const char *Name,int Value);
+   string Find(const char *Name,const char *Default = 0) const;
+   string Find(const 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(const string Name,int Default = 0) const {return FindI(Name.c_str(),Default);};
+   bool FindB(const char *Name,bool Default = false) const;
+   bool FindB(const string Name,bool Default = false) const {return FindB(Name.c_str(),Default);};
+   string FindAny(const char *Name,const char *Default = 0) const;
+             
+   inline void Set(const string Name,string Value) {Set(Name.c_str(),Value);};
+   void CndSet(const char *Name,const string &Value);
+   void Set(const char *Name,const string &Value);
+   void Set(const char *Name,int Value);   

    
    

+   inline bool Exists(const string Name) const {return Exists(Name.c_str());};
+   bool Exists(const char *Name) const;
+   bool ExistsAny(const char *Name) const;
+
+   // clear a whole tree
+   void Clear(const string Name);
+
+   // remove a certain value from a list (e.g. the list of "APT::Keep-Fds")
+   void Clear(const string List, string Value);
+   void Clear(const string List, int Value);
+
+   inline const Item *Tree(const char *Name) const {return Lookup(Name);};
+
+   inline void Dump() { Dump(std::clog); };
+   void Dump(std::ostream& str);
+
+   Configuration(const Item *Root);

    Configuration();
    Configuration();

+   ~Configuration();

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

+bool ReadConfigFile(Configuration &Conf,const string &FName,
+                   bool AsSectional = false,
+                   unsigned Depth = 0);
+
+bool ReadConfigDir(Configuration &Conf,const string &Dir,
+                  bool AsSectional = false,
+                  unsigned Depth = 0);
+

 #endif
 #endif