]>
git.saurik.com Git - apt-legacy.git/blob - apt-pkg/contrib/configuration.h
1 // -*- mode: cpp; mode: fold -*-
3 // $Id: configuration.h,v 1.16 2002/11/11 06:55:50 doogie Exp $
4 /* ######################################################################
8 This class provides a configuration file and command line parser
9 for a tree-oriented configuration environment. All runtime configuration
12 Each configuration name is given as a fully scoped string such as
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).
18 Most things can get by quite happily with,
19 cout << _config->Find("Foo::Bar") << endl;
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
26 ##################################################################### */
28 #ifndef PKGLIB_CONFIGURATION_H
29 #define PKGLIB_CONFIGURATION_H
51 string
FullTag(const Item
*Stop
= 0) const;
53 Item() : Parent(0), Child(0), Next(0) {};
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
65 return ((Configuration
*)this)->Lookup(Name
,false);
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;
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
);
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;
92 void Clear(const string Name
);
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
);
98 inline const Item
*Tree(const char *Name
) const {return Lookup(Name
);};
100 inline void Dump() { Dump(std::clog
); };
101 void Dump(std::ostream
& str
);
103 Configuration(const Item
*Root
);
108 extern Configuration
*_config
;
110 bool ReadConfigFile(Configuration
&Conf
,const string
&FName
,
111 bool AsSectional
= false,
114 bool ReadConfigDir(Configuration
&Conf
,const string
&Dir
,
115 bool AsSectional
= false,