--- libaitcfg/inc/aitcfg.h 2008/08/28 13:17:41 1.1 +++ libaitcfg/inc/aitcfg.h 2010/03/22 15:15:48 1.5 @@ -1,3 +1,11 @@ +/************************************************************************* +* (C) 2008 AITNET ltd - Sofia/Bulgaria - +* by Michael Pounov +* +* $Author: misho $ +* $Id: aitcfg.h,v 1.5 2010/03/22 15:15:48 misho Exp $ +* +*************************************************************************/ #ifndef __AITCFG_H #define __AITCFG_H @@ -17,12 +25,27 @@ typedef struct tagHead sl_config; /* + * Macros for config library. Typecast string to specific config string format. +*/ +#define CFG(x) (unsigned char *)(x) + +#define CFG_ISSET(x) ((long) cfg_FirstItem((x))) + + +/* * InitConfig() Head initializing function for config * @cfg = New head element for init * return: 0 ok; -1 error:: new head element is null */ inline int InitConfig(sl_config * __restrict cfg); /* + * cfg_CreateConfig() Create config file from memory without whitespaces! + * @csConfigName = New config filename + * @cfg = Head list element + * return: 0 ok; -1 error:: can`t save new config +*/ +int cfg_CreateConfig(const char *csConfigName, sl_config * __restrict cfg); +/* * CreateConfig() Create config file from memory * @csConfigName = New config filename * @cfg = Head list element @@ -64,8 +87,32 @@ int ReadConfig(FILE *f, sl_config * __restrict cfg); */ int WriteConfig(FILE *f, sl_config * __restrict cfg); +/* + * cfg_WriteConfig() Write to file from items in config list without whitespaces! + * @f = file resource + * @cfg = Head list element + * return: 0 ok; -1 error:: can`t write to file +*/ +int cfg_WriteConfig(FILE *f, sl_config * __restrict cfg); /* + * ConcatConfig() Concat two list in one + * @cfg = Head list element of main list + * @add_cfg = Head list element of added list + * return: 0 ok; -1 error:: can`t concat lists +*/ +int ConcatConfig(sl_config * __restrict cfg, sl_config * __restrict add_cfg); + +/* + * MergeConfig() Marge two list in one cfg and destroy add_cfg + * @cfg = Head list element of main list + * @add_cfg = Head list element of merged list (destroy after all!) + * return: 0 ok; -1 error:: can`t merge lists +*/ +int MergeConfig(sl_config * __restrict cfg, sl_config * __restrict add_cfg); + + +/* * cfg_FindAttribute() Find attribute position in config list * @cfg = Head list element * @csSec = Config section //[{csSec}] @@ -98,6 +145,13 @@ int cfg_UnsetAttribute(sl_config * __restrict cfg, con * return: NULL item not found or null parameters; !=NULL value const string */ inline const u_char *cfg_GetAttribute(sl_config * __restrict cfg, const u_char *csSec, const u_char *csAttr); + +/* + * cfg_FirstItem() Get first item from config list and return his value + * @cfg = Head list element + * return: NULL if no items in list; !=NULL first pair item +*/ +inline struct tagPair *cfg_FirstItem(sl_config * __restrict cfg); /* * cfg_LoadAttribute() Extended get attribute, if not found item return *default value*