]> git.saurik.com Git - apt-legacy.git/blob - apt-pkg/contrib/configuration.h
Add /etc/apt/preferences.d.
[apt-legacy.git] / apt-pkg / contrib / configuration.h
1 // -*- mode: cpp; mode: fold -*-
2 // Description /*{{{*/
3 // $Id: configuration.h,v 1.16 2002/11/11 06:55:50 doogie Exp $
4 /* ######################################################################
5
6 Configuration Class
7
8 This class provides a configuration file and command line parser
9 for a tree-oriented configuration environment. All runtime configuration
10 is stored in here.
11
12 Each configuration name is given as a fully scoped string such as
13 Foo::Bar
14 And has associated with it a text string. The Configuration class only
15 provides storage and lookup for this tree, other classes provide
16 configuration file formats (and parsers/emitters if needed).
17
18 Most things can get by quite happily with,
19 cout << _config->Find("Foo::Bar") << endl;
20
21 A special extension, support for ordered lists is provided by using the
22 special syntax, "block::list::" the trailing :: designates the
23 item as a list. To access the list you must use the tree function on
24 "block::list".
25
26 ##################################################################### */
27 /*}}}*/
28 #ifndef PKGLIB_CONFIGURATION_H
29 #define PKGLIB_CONFIGURATION_H
30
31
32
33 #include <string>
34 #include <vector>
35 #include <iostream>
36
37 using std::string;
38
39 class Configuration
40 {
41 public:
42
43 struct Item
44 {
45 string Value;
46 string Tag;
47 Item *Parent;
48 Item *Child;
49 Item *Next;
50
51 string FullTag(const Item *Stop = 0) const;
52
53 Item() : Parent(0), Child(0), Next(0) {};
54 };
55
56 private:
57
58 Item *Root;
59 bool ToFree;
60
61 Item *Lookup(Item *Head,const char *S,unsigned long Len,bool Create);
62 Item *Lookup(const char *Name,bool Create);
63 inline const Item *Lookup(const char *Name) const
64 {
65 return ((Configuration *)this)->Lookup(Name,false);
66 }
67
68 public:
69
70 string Find(const char *Name,const char *Default = 0) const;
71 string Find(const string Name,const char *Default = 0) const {return Find(Name.c_str(),Default);};
72 string FindFile(const char *Name,const char *Default = 0) const;
73 string FindDir(const char *Name,const char *Default = 0) const;
74 std::vector<string> FindVector(const string &Name) const;
75 std::vector<string> FindVector(const char *Name) const;
76 int FindI(const char *Name,int Default = 0) const;
77 int FindI(const string Name,int Default = 0) const {return FindI(Name.c_str(),Default);};
78 bool FindB(const char *Name,bool Default = false) const;
79 bool FindB(const string Name,bool Default = false) const {return FindB(Name.c_str(),Default);};
80 string FindAny(const char *Name,const char *Default = 0) const;
81
82 inline void Set(const string Name,string Value) {Set(Name.c_str(),Value);};
83 void CndSet(const char *Name,const string &Value);
84 void Set(const char *Name,const string &Value);
85 void Set(const char *Name,int Value);
86
87 inline bool Exists(const string Name) const {return Exists(Name.c_str());};
88 bool Exists(const char *Name) const;
89 bool ExistsAny(const char *Name) const;
90
91 // clear a whole tree
92 void Clear(const string Name);
93
94 // remove a certain value from a list (e.g. the list of "APT::Keep-Fds")
95 void Clear(const string List, string Value);
96 void Clear(const string List, int Value);
97
98 inline const Item *Tree(const char *Name) const {return Lookup(Name);};
99
100 inline void Dump() { Dump(std::clog); };
101 void Dump(std::ostream& str);
102
103 Configuration(const Item *Root);
104 Configuration();
105 ~Configuration();
106 };
107
108 extern Configuration *_config;
109
110 bool ReadConfigFile(Configuration &Conf,const string &FName,
111 bool AsSectional = false,
112 unsigned Depth = 0);
113
114 bool ReadConfigDir(Configuration &Conf,const string &Dir,
115 bool AsSectional = false,
116 unsigned Depth = 0);
117
118 #endif