| 1 | /********************************************************************\ |
|---|
| 2 | * BitlBee -- An IRC to other IM-networks gateway * |
|---|
| 3 | * * |
|---|
| 4 | * Copyright 2002-2006 Wilmer van der Gaast and others * |
|---|
| 5 | \********************************************************************/ |
|---|
| 6 | |
|---|
| 7 | /* Some stuff to register, handle and save user preferences */ |
|---|
| 8 | |
|---|
| 9 | /* |
|---|
| 10 | This program is free software; you can redistribute it and/or modify |
|---|
| 11 | it under the terms of the GNU General Public License as published by |
|---|
| 12 | the Free Software Foundation; either version 2 of the License, or |
|---|
| 13 | (at your option) any later version. |
|---|
| 14 | |
|---|
| 15 | This program is distributed in the hope that it will be useful, |
|---|
| 16 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
|---|
| 17 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
|---|
| 18 | GNU General Public License for more details. |
|---|
| 19 | |
|---|
| 20 | You should have received a copy of the GNU General Public License with |
|---|
| 21 | the Debian GNU/Linux distribution in /usr/share/common-licenses/GPL; |
|---|
| 22 | if not, write to the Free Software Foundation, Inc., 59 Temple Place, |
|---|
| 23 | Suite 330, Boston, MA 02111-1307 USA |
|---|
| 24 | */ |
|---|
| 25 | |
|---|
| 26 | #ifndef __SET_H__ |
|---|
| 27 | #define __SET_H__ |
|---|
| 28 | |
|---|
| 29 | struct set; |
|---|
| 30 | |
|---|
| 31 | /* This used to be specific to irc_t structures, but it's more generic now |
|---|
| 32 | (so it can also be used for account_t structs). It's pretty simple, but |
|---|
| 33 | so far pretty useful. |
|---|
| 34 | |
|---|
| 35 | In short, it just keeps a linked list of settings/variables and it also |
|---|
| 36 | remembers a default value for every setting. And to prevent the user |
|---|
| 37 | from setting invalid values, you can write an evaluator function for |
|---|
| 38 | every setting, which can check a new value and block it by returning |
|---|
| 39 | NULL, or replace it by returning a new value. See struct set.eval. |
|---|
| 40 | One thing that is really missing here is additional data for the |
|---|
| 41 | evaluator. This could be useful to add minimum and maximum values for |
|---|
| 42 | integers, for example. */ |
|---|
| 43 | |
|---|
| 44 | typedef char *(*set_eval) ( struct set *set, char *value ); |
|---|
| 45 | |
|---|
| 46 | typedef struct set |
|---|
| 47 | { |
|---|
| 48 | void *data; /* Here you can save a pointer to the |
|---|
| 49 | object this settings belongs to. */ |
|---|
| 50 | |
|---|
| 51 | char *key; |
|---|
| 52 | char *value; |
|---|
| 53 | char *def; /* Default value. If the set_setstr() function |
|---|
| 54 | notices a new value is exactly the same as |
|---|
| 55 | the default, value gets set to NULL. So when |
|---|
| 56 | you read a setting, don't forget about this! |
|---|
| 57 | In fact, you should only read values using |
|---|
| 58 | set_getstr/int(). */ |
|---|
| 59 | |
|---|
| 60 | int flags; /* See account.h, for example. set.c doesn't use |
|---|
| 61 | this (yet?). */ |
|---|
| 62 | |
|---|
| 63 | /* Eval: Returns NULL if the value is incorrect or exactly the |
|---|
| 64 | passed value variable. When returning a corrected value, |
|---|
| 65 | set_setstr() should be able to free() the returned string! */ |
|---|
| 66 | set_eval eval; |
|---|
| 67 | struct set *next; |
|---|
| 68 | } set_t; |
|---|
| 69 | |
|---|
| 70 | /* Should be pretty clear. */ |
|---|
| 71 | set_t *set_add( set_t **head, char *key, char *def, set_eval eval, void *data ); |
|---|
| 72 | |
|---|
| 73 | /* Returns the raw set_t. Might be useful sometimes. */ |
|---|
| 74 | set_t *set_find( set_t **head, char *key ); |
|---|
| 75 | |
|---|
| 76 | /* Returns a pointer to the string value of this setting. Don't modify the |
|---|
| 77 | returned string, and don't free() it! */ |
|---|
| 78 | G_MODULE_EXPORT char *set_getstr( set_t **head, char *key ); |
|---|
| 79 | |
|---|
| 80 | /* Get an integer. In previous versions set_getint() was also used to read |
|---|
| 81 | boolean values, but this SHOULD be done with set_getbool() now! */ |
|---|
| 82 | G_MODULE_EXPORT int set_getint( set_t **head, char *key ); |
|---|
| 83 | G_MODULE_EXPORT int set_getbool( set_t **head, char *key ); |
|---|
| 84 | |
|---|
| 85 | /* set_setstr() strdup()s the given value, so after using this function |
|---|
| 86 | you can free() it, if you want. */ |
|---|
| 87 | int set_setstr( set_t **head, char *key, char *value ); |
|---|
| 88 | int set_setint( set_t **head, char *key, int value ); |
|---|
| 89 | void set_del( set_t **head, char *key ); |
|---|
| 90 | |
|---|
| 91 | /* Two very useful generic evaluators. */ |
|---|
| 92 | char *set_eval_int( set_t *set, char *value ); |
|---|
| 93 | char *set_eval_bool( set_t *set, char *value ); |
|---|
| 94 | |
|---|
| 95 | /* Some not very generic evaluators that really shouldn't be here... */ |
|---|
| 96 | char *set_eval_to_char( set_t *set, char *value ); |
|---|
| 97 | char *set_eval_ops( set_t *set, char *value ); |
|---|
| 98 | char *set_eval_charset( set_t *set, char *value ); |
|---|
| 99 | |
|---|
| 100 | #endif /* __SET_H__ */ |
|---|
