Annotation of embedaddon/confuse/doc/html/confuse_8h.html, revision 1.1
1.1 ! misho 1: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
! 2: "http://www.w3.org/TR/html4/strict.dtd">
! 3: <html>
! 4: <head>
! 5: <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
! 6: <title>confuse: confuse.h File Reference</title>
! 7: <link rel="stylesheet" href="tutorial.css" type="text/css">
! 8: </head>
! 9: <body>
! 10:
! 11: <div class="main">
! 12:
! 13: <!-- doxygen-header.html ends here -->
! 14: <!-- Generated by Doxygen 1.5.8 -->
! 15: <div class="navigation" id="top">
! 16: <div class="tabs">
! 17: <ul>
! 18: <li><a href="index.html"><span>Main Page</span></a></li>
! 19: <li><a href="annotated.html"><span>Data Structures</span></a></li>
! 20: <li class="current"><a href="files.html"><span>Files</span></a></li>
! 21: <li><a href="examples.html"><span>Examples</span></a></li>
! 22: </ul>
! 23: </div>
! 24: <div class="tabs">
! 25: <ul>
! 26: <li><a href="files.html"><span>File List</span></a></li>
! 27: <li><a href="globals.html"><span>Globals</span></a></li>
! 28: </ul>
! 29: </div>
! 30: </div>
! 31: <div class="contents">
! 32: <h1>confuse.h File Reference</h1>A configuration file parser library.
! 33: <a href="#_details">More...</a>
! 34: <p>
! 35: <code>#include <stdio.h></code><br>
! 36: <code>#include <stdarg.h></code><br>
! 37:
! 38: <p>
! 39: <a href="confuse_8h-source.html">Go to the source code of this file.</a><table border="0" cellpadding="0" cellspacing="0">
! 40: <tr><td></td></tr>
! 41: <tr><td colspan="2"><br><h2>Data Structures</h2></td></tr>
! 42: <tr><td class="memItemLeft" nowrap align="right" valign="top">struct </td><td class="memItemRight" valign="bottom"><a class="el" href="structcfg__t.html">cfg_t</a></td></tr>
! 43:
! 44: <tr><td class="mdescLeft"> </td><td class="mdescRight">Data structure holding information about a "section". <a href="structcfg__t.html#_details">More...</a><br></td></tr>
! 45: <tr><td class="memItemLeft" nowrap align="right" valign="top">union </td><td class="memItemRight" valign="bottom"><a class="el" href="unioncfg__value__t.html">cfg_value_t</a></td></tr>
! 46:
! 47: <tr><td class="mdescLeft"> </td><td class="mdescRight">Data structure holding the value of a fundamental option value. <a href="unioncfg__value__t.html#_details">More...</a><br></td></tr>
! 48: <tr><td class="memItemLeft" nowrap align="right" valign="top">struct </td><td class="memItemRight" valign="bottom"><a class="el" href="structcfg__defvalue__t.html">cfg_defvalue_t</a></td></tr>
! 49:
! 50: <tr><td class="mdescLeft"> </td><td class="mdescRight">Data structure holding the default value given by the initialization macros. <a href="structcfg__defvalue__t.html#_details">More...</a><br></td></tr>
! 51: <tr><td class="memItemLeft" nowrap align="right" valign="top">struct </td><td class="memItemRight" valign="bottom"><a class="el" href="structcfg__opt__t.html">cfg_opt_t</a></td></tr>
! 52:
! 53: <tr><td class="mdescLeft"> </td><td class="mdescRight">Data structure holding information about an option. <a href="structcfg__opt__t.html#_details">More...</a><br></td></tr>
! 54: <tr><td colspan="2"><br><h2>Defines</h2></td></tr>
! 55: <tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#65df72d236bcc3e7f22c5b2b5c24bded">CFGF_NONE</a> 0</td></tr>
! 56:
! 57: <tr><td class="mdescLeft"> </td><td class="mdescRight">Flags. <a href="#65df72d236bcc3e7f22c5b2b5c24bded"></a><br></td></tr>
! 58: <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="86b522a5daef5c07066b28f1585d2d77"></a><!-- doxytag: member="confuse.h::CFGF_MULTI" ref="86b522a5daef5c07066b28f1585d2d77" args="" -->
! 59: #define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#86b522a5daef5c07066b28f1585d2d77">CFGF_MULTI</a> 1</td></tr>
! 60:
! 61: <tr><td class="mdescLeft"> </td><td class="mdescRight">option may be specified multiple times (only applies to sections) <br></td></tr>
! 62: <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="644afc2caf9da9274ec08407997aa4ef"></a><!-- doxytag: member="confuse.h::CFGF_LIST" ref="644afc2caf9da9274ec08407997aa4ef" args="" -->
! 63: #define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#644afc2caf9da9274ec08407997aa4ef">CFGF_LIST</a> 2</td></tr>
! 64:
! 65: <tr><td class="mdescLeft"> </td><td class="mdescRight">option is a list <br></td></tr>
! 66: <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="7adecc621a1910b8807c613051bd8d1d"></a><!-- doxytag: member="confuse.h::CFGF_NOCASE" ref="7adecc621a1910b8807c613051bd8d1d" args="" -->
! 67: #define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#7adecc621a1910b8807c613051bd8d1d">CFGF_NOCASE</a> 4</td></tr>
! 68:
! 69: <tr><td class="mdescLeft"> </td><td class="mdescRight">configuration file is case insensitive <br></td></tr>
! 70: <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="65d20dbd5b778dd1bf3b3895206b4497"></a><!-- doxytag: member="confuse.h::CFGF_TITLE" ref="65d20dbd5b778dd1bf3b3895206b4497" args="" -->
! 71: #define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#65d20dbd5b778dd1bf3b3895206b4497">CFGF_TITLE</a> 8</td></tr>
! 72:
! 73: <tr><td class="mdescLeft"> </td><td class="mdescRight">option has a title (only applies to sections) <br></td></tr>
! 74: <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="9020ea37bfdb4f3e88a18d0a0d00cdd9"></a><!-- doxytag: member="confuse.h::CFGF_NODEFAULT" ref="9020ea37bfdb4f3e88a18d0a0d00cdd9" args="" -->
! 75: #define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#9020ea37bfdb4f3e88a18d0a0d00cdd9">CFGF_NODEFAULT</a> 16</td></tr>
! 76:
! 77: <tr><td class="mdescLeft"> </td><td class="mdescRight">option has no default value <br></td></tr>
! 78: <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="0f8c2f9b82f0338efdc22df54805a467"></a><!-- doxytag: member="confuse.h::CFGF_NO_TITLE_DUPES" ref="0f8c2f9b82f0338efdc22df54805a467" args="" -->
! 79: #define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#0f8c2f9b82f0338efdc22df54805a467">CFGF_NO_TITLE_DUPES</a> 32</td></tr>
! 80:
! 81: <tr><td class="mdescLeft"> </td><td class="mdescRight">multiple section titles must be unique (duplicates raises an error, only applies to sections) <br></td></tr>
! 82: <tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#66a1002180229809620b9bf2d3b888a6">CFG_SUCCESS</a> 0</td></tr>
! 83:
! 84: <tr><td class="mdescLeft"> </td><td class="mdescRight">Return codes from <a class="el" href="confuse_8h.html#0fca327466956c5580199e24397d49fe" title="Parse a configuration file.">cfg_parse()</a>. <a href="#66a1002180229809620b9bf2d3b888a6"></a><br></td></tr>
! 85: <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="963e2ee16396dcf36f6d1937faa00f0c"></a><!-- doxytag: member="confuse.h::CFG_STR" ref="963e2ee16396dcf36f6d1937faa00f0c" args="(name, def, flags)" -->
! 86: #define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#963e2ee16396dcf36f6d1937faa00f0c">CFG_STR</a>(name, def, flags) __CFG_STR(name, def, flags, 0, 0)</td></tr>
! 87:
! 88: <tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize a string option. <br></td></tr>
! 89: <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="db9b1c168e72a3e065d2a06f2ed46c9f"></a><!-- doxytag: member="confuse.h::CFG_STR_LIST" ref="db9b1c168e72a3e065d2a06f2ed46c9f" args="(name, def, flags)" -->
! 90: #define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#db9b1c168e72a3e065d2a06f2ed46c9f">CFG_STR_LIST</a>(name, def, flags) __CFG_STR_LIST(name, def, flags, 0, 0)</td></tr>
! 91:
! 92: <tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize a string list option. <br></td></tr>
! 93: <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="b5a56a69f0f8236be65c1d35a94b4437"></a><!-- doxytag: member="confuse.h::CFG_STR_CB" ref="b5a56a69f0f8236be65c1d35a94b4437" args="(name, def, flags, cb)" -->
! 94: #define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#b5a56a69f0f8236be65c1d35a94b4437">CFG_STR_CB</a>(name, def, flags, cb) __CFG_STR(name, def, flags, 0, cb)</td></tr>
! 95:
! 96: <tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize a string option with a value parsing callback. <br></td></tr>
! 97: <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="1ddedb0317b76dd9da7e8a9f7a585224"></a><!-- doxytag: member="confuse.h::CFG_STR_LIST_CB" ref="1ddedb0317b76dd9da7e8a9f7a585224" args="(name, def, flags, cb)" -->
! 98: #define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#1ddedb0317b76dd9da7e8a9f7a585224">CFG_STR_LIST_CB</a>(name, def, flags, cb) __CFG_STR_LIST(name, def, flags, 0, cb)</td></tr>
! 99:
! 100: <tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize a string list option with a value parsing callback. <br></td></tr>
! 101: <tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#e54fbbc31bd8c7ec8d7f04597a9f749d">CFG_SIMPLE_STR</a>(name, svalue) __CFG_STR(name, 0, CFGF_NONE, svalue, 0)</td></tr>
! 102:
! 103: <tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize a "simple" string option. <a href="#e54fbbc31bd8c7ec8d7f04597a9f749d"></a><br></td></tr>
! 104: <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="c2b17561e944264c594ea0802e56d308"></a><!-- doxytag: member="confuse.h::CFG_INT" ref="c2b17561e944264c594ea0802e56d308" args="(name, def, flags)" -->
! 105: #define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#c2b17561e944264c594ea0802e56d308">CFG_INT</a>(name, def, flags) __CFG_INT(name, def, flags, 0, 0)</td></tr>
! 106:
! 107: <tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize an integer option. <br></td></tr>
! 108: <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="736ad9fa5db2697c232f490e84bbf622"></a><!-- doxytag: member="confuse.h::CFG_INT_LIST" ref="736ad9fa5db2697c232f490e84bbf622" args="(name, def, flags)" -->
! 109: #define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#736ad9fa5db2697c232f490e84bbf622">CFG_INT_LIST</a>(name, def, flags) __CFG_INT_LIST(name, def, flags, 0, 0)</td></tr>
! 110:
! 111: <tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize an integer list option. <br></td></tr>
! 112: <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="6f80d4ee3191ce3fb2f9e3b8fba50d49"></a><!-- doxytag: member="confuse.h::CFG_INT_CB" ref="6f80d4ee3191ce3fb2f9e3b8fba50d49" args="(name, def, flags, cb)" -->
! 113: #define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#6f80d4ee3191ce3fb2f9e3b8fba50d49">CFG_INT_CB</a>(name, def, flags, cb) __CFG_INT(name, def, flags, 0, cb)</td></tr>
! 114:
! 115: <tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize an integer option with a value parsing callback. <br></td></tr>
! 116: <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="19c5daa71195724822a75b1fbd287209"></a><!-- doxytag: member="confuse.h::CFG_INT_LIST_CB" ref="19c5daa71195724822a75b1fbd287209" args="(name, def, flags, cb)" -->
! 117: #define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#19c5daa71195724822a75b1fbd287209">CFG_INT_LIST_CB</a>(name, def, flags, cb) __CFG_INT_LIST(name, def, flags, 0, cb)</td></tr>
! 118:
! 119: <tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize an integer list option with a value parsing callback. <br></td></tr>
! 120: <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="88fa2e73a1294c7e8a1f1519b68ce0ff"></a><!-- doxytag: member="confuse.h::CFG_SIMPLE_INT" ref="88fa2e73a1294c7e8a1f1519b68ce0ff" args="(name, svalue)" -->
! 121: #define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#88fa2e73a1294c7e8a1f1519b68ce0ff">CFG_SIMPLE_INT</a>(name, svalue) __CFG_INT(name, 0, CFGF_NONE, svalue, 0)</td></tr>
! 122:
! 123: <tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize a "simple" integer option (see documentation for CFG_SIMPLE_STR for more information). <br></td></tr>
! 124: <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="9c2060101b9c5e0d31a31ecd0dc6941d"></a><!-- doxytag: member="confuse.h::CFG_FLOAT" ref="9c2060101b9c5e0d31a31ecd0dc6941d" args="(name, def, flags)" -->
! 125: #define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#9c2060101b9c5e0d31a31ecd0dc6941d">CFG_FLOAT</a>(name, def, flags) __CFG_FLOAT(name, def, flags, 0, 0)</td></tr>
! 126:
! 127: <tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize a floating point option. <br></td></tr>
! 128: <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="09dd396c99a0948f03c14214e7735410"></a><!-- doxytag: member="confuse.h::CFG_FLOAT_LIST" ref="09dd396c99a0948f03c14214e7735410" args="(name, def, flags)" -->
! 129: #define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#09dd396c99a0948f03c14214e7735410">CFG_FLOAT_LIST</a>(name, def, flags) __CFG_FLOAT_LIST(name, def, flags, 0, 0)</td></tr>
! 130:
! 131: <tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize a floating point list option. <br></td></tr>
! 132: <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="f4e3227ba01b96f42e5594f25fee00f3"></a><!-- doxytag: member="confuse.h::CFG_FLOAT_CB" ref="f4e3227ba01b96f42e5594f25fee00f3" args="(name, def, flags, cb)" -->
! 133: #define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#f4e3227ba01b96f42e5594f25fee00f3">CFG_FLOAT_CB</a>(name, def, flags, cb) __CFG_FLOAT(name, def, flags, 0, cb)</td></tr>
! 134:
! 135: <tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize a floating point option with a value parsing callback. <br></td></tr>
! 136: <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="82567f08b6a432bb92ba9718285b3e7b"></a><!-- doxytag: member="confuse.h::CFG_FLOAT_LIST_CB" ref="82567f08b6a432bb92ba9718285b3e7b" args="(name, def, flags, cb)" -->
! 137: #define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#82567f08b6a432bb92ba9718285b3e7b">CFG_FLOAT_LIST_CB</a>(name, def, flags, cb) __CFG_FLOAT_LIST(name, def, flags, 0, cb)</td></tr>
! 138:
! 139: <tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize a floating point list option with a value parsing callback. <br></td></tr>
! 140: <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="073b3b12a5ba4648a1f4f1aa40ff3a2a"></a><!-- doxytag: member="confuse.h::CFG_SIMPLE_FLOAT" ref="073b3b12a5ba4648a1f4f1aa40ff3a2a" args="(name, svalue)" -->
! 141: #define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#073b3b12a5ba4648a1f4f1aa40ff3a2a">CFG_SIMPLE_FLOAT</a>(name, svalue) __CFG_FLOAT(name, 0, CFGF_NONE, svalue, 0)</td></tr>
! 142:
! 143: <tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize a "simple" floating point option (see documentation for CFG_SIMPLE_STR for more information). <br></td></tr>
! 144: <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="5a49fffc6735970c739e34d51a39c95d"></a><!-- doxytag: member="confuse.h::CFG_BOOL" ref="5a49fffc6735970c739e34d51a39c95d" args="(name, def, flags)" -->
! 145: #define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#5a49fffc6735970c739e34d51a39c95d">CFG_BOOL</a>(name, def, flags) __CFG_BOOL(name, def, flags, 0, 0)</td></tr>
! 146:
! 147: <tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize a boolean option. <br></td></tr>
! 148: <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="d5449a10a53d3ce91ac5a5e0fbffdf35"></a><!-- doxytag: member="confuse.h::CFG_BOOL_LIST" ref="d5449a10a53d3ce91ac5a5e0fbffdf35" args="(name, def, flags)" -->
! 149: #define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#d5449a10a53d3ce91ac5a5e0fbffdf35">CFG_BOOL_LIST</a>(name, def, flags) __CFG_BOOL_LIST(name, def, flags, 0, 0)</td></tr>
! 150:
! 151: <tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize a boolean list option. <br></td></tr>
! 152: <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="7951fcb3b77e290f5e2a04e1a7ee5f96"></a><!-- doxytag: member="confuse.h::CFG_BOOL_CB" ref="7951fcb3b77e290f5e2a04e1a7ee5f96" args="(name, def, flags, cb)" -->
! 153: #define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#7951fcb3b77e290f5e2a04e1a7ee5f96">CFG_BOOL_CB</a>(name, def, flags, cb) __CFG_BOOL(name, def, flags, 0, cb)</td></tr>
! 154:
! 155: <tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize a boolean option with a value parsing callback. <br></td></tr>
! 156: <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="2d905913ddeeb2301dbbc039d6a73d31"></a><!-- doxytag: member="confuse.h::CFG_BOOL_LIST_CB" ref="2d905913ddeeb2301dbbc039d6a73d31" args="(name, def, flags, cb)" -->
! 157: #define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#2d905913ddeeb2301dbbc039d6a73d31">CFG_BOOL_LIST_CB</a>(name, def, flags, cb) __CFG_BOOL_LIST(name, def, flags, 0, cb)</td></tr>
! 158:
! 159: <tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize a boolean list option with a value parsing callback. <br></td></tr>
! 160: <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="228dc9c22fbcbeabed4d171774662ce8"></a><!-- doxytag: member="confuse.h::CFG_SIMPLE_BOOL" ref="228dc9c22fbcbeabed4d171774662ce8" args="(name, svalue)" -->
! 161: #define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#228dc9c22fbcbeabed4d171774662ce8">CFG_SIMPLE_BOOL</a>(name, svalue) __CFG_BOOL(name, cfg_false, CFGF_NONE, svalue, 0)</td></tr>
! 162:
! 163: <tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize a "simple" boolean option (see documentation for CFG_SIMPLE_STR for more information). <br></td></tr>
! 164: <tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#043d5c79624269e5f60f59a698e461a6">CFG_SEC</a>(name, opts, flags) {name,CFGT_SEC,0,0,flags,opts,{0,0,cfg_false,0,0},0,0,0,0,0,0}</td></tr>
! 165:
! 166: <tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize a section. <a href="#043d5c79624269e5f60f59a698e461a6"></a><br></td></tr>
! 167: <tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#b1ff85d6346cdefeb2ec2b696e50fde9">CFG_FUNC</a>(name, func) {name,CFGT_FUNC,0,0,CFGF_NONE,0,{0,0,cfg_false,0,0},func,0,0,0,0,0}</td></tr>
! 168:
! 169: <tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize a function. <a href="#b1ff85d6346cdefeb2ec2b696e50fde9"></a><br></td></tr>
! 170: <tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#240cd896d81e219b3acbcf8f7279ffbb">CFG_PTR_CB</a>(name, def, flags, parsecb, freecb) __CFG_PTR(name, def, flags, 0, parsecb, freecb)</td></tr>
! 171:
! 172: <tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize a user-defined option. <a href="#240cd896d81e219b3acbcf8f7279ffbb"></a><br></td></tr>
! 173: <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="6846af076094d05ca6b0041ebfef0f2b"></a><!-- doxytag: member="confuse.h::CFG_PTR_LIST_CB" ref="6846af076094d05ca6b0041ebfef0f2b" args="(name, def, flags, parsecb, freecb)" -->
! 174: #define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#6846af076094d05ca6b0041ebfef0f2b">CFG_PTR_LIST_CB</a>(name, def, flags, parsecb, freecb) __CFG_PTR(name, def, flags | CFGF_LIST, 0, parsecb, freecb)</td></tr>
! 175:
! 176: <tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize a list of user-defined options. <br></td></tr>
! 177: <tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#6b29dd8a4c6cd3d392d4ab6b2e535597">CFG_END</a>() {0,CFGT_NONE,0,0,CFGF_NONE,0,{0,0,cfg_false,0,0},0,0,0,0,0,0}</td></tr>
! 178:
! 179: <tr><td class="mdescLeft"> </td><td class="mdescRight">Terminate list of options. <a href="#6b29dd8a4c6cd3d392d4ab6b2e535597"></a><br></td></tr>
! 180: <tr><td colspan="2"><br><h2>Typedefs</h2></td></tr>
! 181: <tr><td class="memItemLeft" nowrap align="right" valign="top">typedef int(* </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#f781d6e81a4dec706ae4d9848b26918d">cfg_func_t</a> )(<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, <a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *opt, int argc, const char **argv)</td></tr>
! 182:
! 183: <tr><td class="mdescLeft"> </td><td class="mdescRight">Function prototype used by CFGT_FUNC options. <a href="#f781d6e81a4dec706ae4d9848b26918d"></a><br></td></tr>
! 184: <tr><td class="memItemLeft" nowrap align="right" valign="top">typedef void(* </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#488182780ff16a94457f0d1242416154">cfg_print_func_t</a> )(<a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *opt, unsigned int index, FILE *fp)</td></tr>
! 185:
! 186: <tr><td class="mdescLeft"> </td><td class="mdescRight">Function prototype used by the cfg_print_ functions. <a href="#488182780ff16a94457f0d1242416154"></a><br></td></tr>
! 187: <tr><td class="memItemLeft" nowrap align="right" valign="top">typedef int(* </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#352a1a9074937ca131860891ed5c18c0">cfg_callback_t</a> )(<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, <a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *opt, const char *value, void *result)</td></tr>
! 188:
! 189: <tr><td class="mdescLeft"> </td><td class="mdescRight">Value parsing callback prototype. <a href="#352a1a9074937ca131860891ed5c18c0"></a><br></td></tr>
! 190: <tr><td class="memItemLeft" nowrap align="right" valign="top">typedef int(* </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#4d01aba329210d110238d64d2047d502">cfg_validate_callback_t</a> )(<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, <a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *opt)</td></tr>
! 191:
! 192: <tr><td class="mdescLeft"> </td><td class="mdescRight">Validating callback prototype. <a href="#4d01aba329210d110238d64d2047d502"></a><br></td></tr>
! 193: <tr><td class="memItemLeft" nowrap align="right" valign="top">typedef void(* </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#a784e6c6702dedf1eb00fcfe0899ecab">cfg_free_func_t</a> )(void *value)</td></tr>
! 194:
! 195: <tr><td class="mdescLeft"> </td><td class="mdescRight">User-defined memory release function for CFG_PTR values. <a href="#a784e6c6702dedf1eb00fcfe0899ecab"></a><br></td></tr>
! 196: <tr><td class="memItemLeft" nowrap align="right" valign="top">typedef void(* </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#e4244b478d80a5ec06a1f5a46dd04fbe">cfg_errfunc_t</a> )(<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *fmt, va_list ap)</td></tr>
! 197:
! 198: <tr><td class="mdescLeft"> </td><td class="mdescRight">Error reporting function. <a href="#e4244b478d80a5ec06a1f5a46dd04fbe"></a><br></td></tr>
! 199: <tr><td colspan="2"><br><h2>Enumerations</h2></td></tr>
! 200: <tr><td class="memItemLeft" nowrap align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#9c62155b0deae0e1831507520a2ff7c7">cfg_type_t</a> { , <br>
! 201: <a class="el" href="confuse_8h.html#9c62155b0deae0e1831507520a2ff7c7f397ec05171bfacd9944b3d538fbd6dc">CFGT_INT</a>,
! 202: <a class="el" href="confuse_8h.html#9c62155b0deae0e1831507520a2ff7c7bd237f20c366857f5521da911ba813cb">CFGT_FLOAT</a>,
! 203: <a class="el" href="confuse_8h.html#9c62155b0deae0e1831507520a2ff7c7c6a18c97187c38648e11f18ad465f4f3">CFGT_STR</a>,
! 204: <a class="el" href="confuse_8h.html#9c62155b0deae0e1831507520a2ff7c78f04ccea50fbe06f9a118b4423ead6fd">CFGT_BOOL</a>,
! 205: <br>
! 206: <a class="el" href="confuse_8h.html#9c62155b0deae0e1831507520a2ff7c7a786f6288e70d0ec5fc0ef38f1671f1b">CFGT_SEC</a>,
! 207: <a class="el" href="confuse_8h.html#9c62155b0deae0e1831507520a2ff7c7531bc0d05779dd0fbbe90ac9ae744c0f">CFGT_FUNC</a>,
! 208: <a class="el" href="confuse_8h.html#9c62155b0deae0e1831507520a2ff7c71b2260acd1f600d08b1317676b90dbb4">CFGT_PTR</a>
! 209: <br>
! 210: }</td></tr>
! 211:
! 212: <tr><td class="mdescLeft"> </td><td class="mdescRight">Fundamental option types. <a href="confuse_8h.html#9c62155b0deae0e1831507520a2ff7c7">More...</a><br></td></tr>
! 213: <tr><td class="memItemLeft" nowrap align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#4bce4b6aed9b07489d6a5c70321907e4">cfg_bool_t</a> </td></tr>
! 214:
! 215: <tr><td class="mdescLeft"> </td><td class="mdescRight">Boolean values. <a href="confuse_8h.html#4bce4b6aed9b07489d6a5c70321907e4">More...</a><br></td></tr>
! 216: <tr><td colspan="2"><br><h2>Functions</h2></td></tr>
! 217: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT <a class="el" href="structcfg__t.html">cfg_t</a> *__export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#ec07794916564c8ab437e030ac618aa8">cfg_init</a> (<a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *opts, cfg_flag_t flags)</td></tr>
! 218:
! 219: <tr><td class="mdescLeft"> </td><td class="mdescRight">Create and initialize a <a class="el" href="structcfg__t.html" title="Data structure holding information about a "section".">cfg_t</a> structure. <a href="#ec07794916564c8ab437e030ac618aa8"></a><br></td></tr>
! 220: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT int __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#0fca327466956c5580199e24397d49fe">cfg_parse</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *filename)</td></tr>
! 221:
! 222: <tr><td class="mdescLeft"> </td><td class="mdescRight">Parse a configuration file. <a href="#0fca327466956c5580199e24397d49fe"></a><br></td></tr>
! 223: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT int __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#7ff54be21c704c3150ad439d7e17dcca">cfg_parse_fp</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, FILE *fp)</td></tr>
! 224:
! 225: <tr><td class="mdescLeft"> </td><td class="mdescRight">Same as <a class="el" href="confuse_8h.html#0fca327466956c5580199e24397d49fe" title="Parse a configuration file.">cfg_parse()</a> above, but takes an already opened file as argument. <a href="#7ff54be21c704c3150ad439d7e17dcca"></a><br></td></tr>
! 226: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT int __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#6da020721a065f359cf343f014e7834c">cfg_parse_buf</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *buf)</td></tr>
! 227:
! 228: <tr><td class="mdescLeft"> </td><td class="mdescRight">Same as <a class="el" href="confuse_8h.html#0fca327466956c5580199e24397d49fe" title="Parse a configuration file.">cfg_parse()</a> above, but takes a character buffer as argument. <a href="#6da020721a065f359cf343f014e7834c"></a><br></td></tr>
! 229: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT void __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#f6003c72a220f36cdecd3a14bd2285cc">cfg_free_value</a> (<a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *opt)</td></tr>
! 230:
! 231: <tr><td class="mdescLeft"> </td><td class="mdescRight">Free the memory allocated for the values of a given option. <a href="#f6003c72a220f36cdecd3a14bd2285cc"></a><br></td></tr>
! 232: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT void __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#0601a1513882caf574ea91a2177bdfdb">cfg_free</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg)</td></tr>
! 233:
! 234: <tr><td class="mdescLeft"> </td><td class="mdescRight">Free a <a class="el" href="structcfg__t.html" title="Data structure holding information about a "section".">cfg_t</a> context. <a href="#0601a1513882caf574ea91a2177bdfdb"></a><br></td></tr>
! 235: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT <a class="el" href="confuse_8h.html#e4244b478d80a5ec06a1f5a46dd04fbe">cfg_errfunc_t</a> __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#e5cd3df98ec4c9895fbe73fd1c32f7a1">cfg_set_error_function</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, <a class="el" href="confuse_8h.html#e4244b478d80a5ec06a1f5a46dd04fbe">cfg_errfunc_t</a> errfunc)</td></tr>
! 236:
! 237: <tr><td class="mdescLeft"> </td><td class="mdescRight">Install a user-defined error reporting function. <a href="#e5cd3df98ec4c9895fbe73fd1c32f7a1"></a><br></td></tr>
! 238: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT void __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#5b448a145f12b67e90bd4e6bd387f129">cfg_error</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *fmt,...)</td></tr>
! 239:
! 240: <tr><td class="mdescLeft"> </td><td class="mdescRight">Show a parser error. <a href="#5b448a145f12b67e90bd4e6bd387f129"></a><br></td></tr>
! 241: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT signed long __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#baa00b2bb179bfc1062c67da8b2beae3">cfg_opt_getnint</a> (<a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *opt, unsigned int index)</td></tr>
! 242:
! 243: <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the value of an integer option, given a <a class="el" href="structcfg__opt__t.html" title="Data structure holding information about an option.">cfg_opt_t</a> pointer. <a href="#baa00b2bb179bfc1062c67da8b2beae3"></a><br></td></tr>
! 244: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT long int __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#ddba63989fbf548cb0365ce875f138d4">cfg_getnint</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *name, unsigned int index)</td></tr>
! 245:
! 246: <tr><td class="mdescLeft"> </td><td class="mdescRight">Indexed version of <a class="el" href="confuse_8h.html#aa50eb2942ae8e7cb7f9ccbfe002b3cd" title="Returns the value of an integer option.">cfg_getint()</a>, used for lists. <a href="#ddba63989fbf548cb0365ce875f138d4"></a><br></td></tr>
! 247: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT long int __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#aa50eb2942ae8e7cb7f9ccbfe002b3cd">cfg_getint</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *name)</td></tr>
! 248:
! 249: <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the value of an integer option. <a href="#aa50eb2942ae8e7cb7f9ccbfe002b3cd"></a><br></td></tr>
! 250: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT double __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#a93c59e332c95937db84f93c1a9b25bd">cfg_opt_getnfloat</a> (<a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *opt, unsigned int index)</td></tr>
! 251:
! 252: <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the value of a floating point option, given a <a class="el" href="structcfg__opt__t.html" title="Data structure holding information about an option.">cfg_opt_t</a> pointer. <a href="#a93c59e332c95937db84f93c1a9b25bd"></a><br></td></tr>
! 253: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT double __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#af63837150498ce6ecd530a9769f9e43">cfg_getnfloat</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *name, unsigned int index)</td></tr>
! 254:
! 255: <tr><td class="mdescLeft"> </td><td class="mdescRight">Indexed version of <a class="el" href="confuse_8h.html#40e3d18ed9fbf5eae90aec58d68cb474" title="Returns the value of a floating point option.">cfg_getfloat()</a>, used for lists. <a href="#af63837150498ce6ecd530a9769f9e43"></a><br></td></tr>
! 256: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT double __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#40e3d18ed9fbf5eae90aec58d68cb474">cfg_getfloat</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *name)</td></tr>
! 257:
! 258: <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the value of a floating point option. <a href="#40e3d18ed9fbf5eae90aec58d68cb474"></a><br></td></tr>
! 259: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT char *__export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#99289f214566005664f05cac4dc50318">cfg_opt_getnstr</a> (<a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *opt, unsigned int index)</td></tr>
! 260:
! 261: <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the value of a string option, given a <a class="el" href="structcfg__opt__t.html" title="Data structure holding information about an option.">cfg_opt_t</a> pointer. <a href="#99289f214566005664f05cac4dc50318"></a><br></td></tr>
! 262: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT char *__export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#abb00a590331a4d9d4e772201dff34d1">cfg_getnstr</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *name, unsigned int index)</td></tr>
! 263:
! 264: <tr><td class="mdescLeft"> </td><td class="mdescRight">Indexed version of <a class="el" href="confuse_8h.html#4a9c34acc55cca63649c088d98053905" title="Returns the value of a string option.">cfg_getstr()</a>, used for lists. <a href="#abb00a590331a4d9d4e772201dff34d1"></a><br></td></tr>
! 265: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT char *__export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#4a9c34acc55cca63649c088d98053905">cfg_getstr</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *name)</td></tr>
! 266:
! 267: <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the value of a string option. <a href="#4a9c34acc55cca63649c088d98053905"></a><br></td></tr>
! 268: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT <a class="el" href="confuse_8h.html#4bce4b6aed9b07489d6a5c70321907e4">cfg_bool_t</a> __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#f49441953ac0c45960728b347c25dba3">cfg_opt_getnbool</a> (<a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *opt, unsigned int index)</td></tr>
! 269:
! 270: <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the value of a boolean option, given a <a class="el" href="structcfg__opt__t.html" title="Data structure holding information about an option.">cfg_opt_t</a> pointer. <a href="#f49441953ac0c45960728b347c25dba3"></a><br></td></tr>
! 271: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT <a class="el" href="confuse_8h.html#4bce4b6aed9b07489d6a5c70321907e4">cfg_bool_t</a> __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#8984944ec9de3a67e3007bfba32f2127">cfg_getnbool</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *name, unsigned int index)</td></tr>
! 272:
! 273: <tr><td class="mdescLeft"> </td><td class="mdescRight">Indexed version of <a class="el" href="confuse_8h.html#b4903f75c29f9c2973696039c4f5c0df" title="Returns the value of a boolean option.">cfg_getbool()</a>, used for lists. <a href="#8984944ec9de3a67e3007bfba32f2127"></a><br></td></tr>
! 274: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT <a class="el" href="confuse_8h.html#4bce4b6aed9b07489d6a5c70321907e4">cfg_bool_t</a> __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#b4903f75c29f9c2973696039c4f5c0df">cfg_getbool</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *name)</td></tr>
! 275:
! 276: <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the value of a boolean option. <a href="#b4903f75c29f9c2973696039c4f5c0df"></a><br></td></tr>
! 277: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT void *__export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#d4f0fdb31b6c0113b3c78891e8ee5429">cfg_getptr</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *name)</td></tr>
! 278:
! 279: <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the value of a user-defined option (void pointer). <a href="#d4f0fdb31b6c0113b3c78891e8ee5429"></a><br></td></tr>
! 280: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT <a class="el" href="structcfg__t.html">cfg_t</a> *__export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#4312c6bc126283ad8b6dc849c1138a71">cfg_opt_getnsec</a> (<a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *opt, unsigned int index)</td></tr>
! 281:
! 282: <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the value of a section option, given a <a class="el" href="structcfg__opt__t.html" title="Data structure holding information about an option.">cfg_opt_t</a> pointer. <a href="#4312c6bc126283ad8b6dc849c1138a71"></a><br></td></tr>
! 283: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT <a class="el" href="structcfg__t.html">cfg_t</a> *__export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#d5e8eea765588892053b73eed4017edd">cfg_getnsec</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *name, unsigned int index)</td></tr>
! 284:
! 285: <tr><td class="mdescLeft"> </td><td class="mdescRight">Indexed version of <a class="el" href="confuse_8h.html#a1339bde1f672aa0279a51bf2324545d" title="Returns the value of a section option.">cfg_getsec()</a>, used for sections with the CFGF_MULTI flag set. <a href="#d5e8eea765588892053b73eed4017edd"></a><br></td></tr>
! 286: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT <a class="el" href="structcfg__t.html">cfg_t</a> *__export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#dec6a5049ac8306b0892f274e6d406ad">cfg_opt_gettsec</a> (<a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *opt, const char *title)</td></tr>
! 287:
! 288: <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the value of a section option, given a <a class="el" href="structcfg__opt__t.html" title="Data structure holding information about an option.">cfg_opt_t</a> pointer and the title. <a href="#dec6a5049ac8306b0892f274e6d406ad"></a><br></td></tr>
! 289: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT <a class="el" href="structcfg__t.html">cfg_t</a> *__export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#c1fda0e6937653d891ae276ae69d0f76">cfg_gettsec</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *name, const char *title)</td></tr>
! 290:
! 291: <tr><td class="mdescLeft"> </td><td class="mdescRight">Return a section given the title, used for section with the CFGF_TITLE flag set. <a href="#c1fda0e6937653d891ae276ae69d0f76"></a><br></td></tr>
! 292: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT <a class="el" href="structcfg__t.html">cfg_t</a> *__export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#a1339bde1f672aa0279a51bf2324545d">cfg_getsec</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *name)</td></tr>
! 293:
! 294: <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the value of a section option. <a href="#a1339bde1f672aa0279a51bf2324545d"></a><br></td></tr>
! 295: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT unsigned int __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#1648e78297e9bc970b1f3fa90a715da6">cfg_opt_size</a> (<a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *opt)</td></tr>
! 296:
! 297: <tr><td class="mdescLeft"> </td><td class="mdescRight">Return the number of values this option has. <a href="#1648e78297e9bc970b1f3fa90a715da6"></a><br></td></tr>
! 298: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT unsigned int __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#cb8b2b9aa7d9e2e3c0eca67ea27bed15">cfg_size</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *name)</td></tr>
! 299:
! 300: <tr><td class="mdescLeft"> </td><td class="mdescRight">Return the number of values this option has. <a href="#cb8b2b9aa7d9e2e3c0eca67ea27bed15"></a><br></td></tr>
! 301: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT const char *__export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#e5681800390fa1dad4b1412ef5288de7">cfg_title</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg)</td></tr>
! 302:
! 303: <tr><td class="mdescLeft"> </td><td class="mdescRight">Return the title of a section. <a href="#e5681800390fa1dad4b1412ef5288de7"></a><br></td></tr>
! 304: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT const char *__export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#af379c267736432e004cccf3b2786bfa">cfg_name</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg)</td></tr>
! 305:
! 306: <tr><td class="mdescLeft"> </td><td class="mdescRight">Return the name of a section. <a href="#af379c267736432e004cccf3b2786bfa"></a><br></td></tr>
! 307: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT const char *__export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#6d3645d6140afbd45b0f2b1475e56ffe">cfg_opt_name</a> (<a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *opt)</td></tr>
! 308:
! 309: <tr><td class="mdescLeft"> </td><td class="mdescRight">Return the name of an option. <a href="#6d3645d6140afbd45b0f2b1475e56ffe"></a><br></td></tr>
! 310: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT int __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#73e8e62914759632e5d5165fa877f4b3">cfg_include</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, <a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *opt, int argc, const char **argv)</td></tr>
! 311:
! 312: <tr><td class="mdescLeft"> </td><td class="mdescRight">Predefined include-function. <a href="#73e8e62914759632e5d5165fa877f4b3"></a><br></td></tr>
! 313: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT char *__export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#ccd838b44797a5a89dbfd3ab60203375">cfg_tilde_expand</a> (const char *filename)</td></tr>
! 314:
! 315: <tr><td class="mdescLeft"> </td><td class="mdescRight">Does tilde expansion (~ -> $HOME) on the filename. <a href="#ccd838b44797a5a89dbfd3ab60203375"></a><br></td></tr>
! 316: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT int __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#527f63939bf3f0b5d635fd86cd562086">cfg_parse_boolean</a> (const char *s)</td></tr>
! 317:
! 318: <tr><td class="mdescLeft"> </td><td class="mdescRight">Parse a boolean option string. <a href="#527f63939bf3f0b5d635fd86cd562086"></a><br></td></tr>
! 319: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT <a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *__export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#33f48558624569678272f46925ead40f">cfg_getopt</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *name)</td></tr>
! 320:
! 321: <tr><td class="mdescLeft"> </td><td class="mdescRight">Return an option given it's name. <a href="#33f48558624569678272f46925ead40f"></a><br></td></tr>
! 322: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT <a class="el" href="unioncfg__value__t.html">cfg_value_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#a5ad795ccedf6aeec73f5b2ec2714653">cfg_setopt</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, <a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *opt, char *value)</td></tr>
! 323:
! 324: <tr><td class="mdescLeft"> </td><td class="mdescRight">Set an option (create an instance of an option). <a href="#a5ad795ccedf6aeec73f5b2ec2714653"></a><br></td></tr>
! 325: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT void __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#47cf0b1d0a9aebbff9846937be98f5bb">cfg_opt_setnint</a> (<a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *opt, long int value, unsigned int index)</td></tr>
! 326:
! 327: <tr><td class="mdescLeft"> </td><td class="mdescRight">Set a value of an integer option. <a href="#47cf0b1d0a9aebbff9846937be98f5bb"></a><br></td></tr>
! 328: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT void __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#9e145714b684d85ced96f32068ec0094">cfg_setint</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *name, long int value)</td></tr>
! 329:
! 330: <tr><td class="mdescLeft"> </td><td class="mdescRight">Set the value of an integer option given its name. <a href="#9e145714b684d85ced96f32068ec0094"></a><br></td></tr>
! 331: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT void __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#8b94a2e75abe7536ab9af8ee7c7c048b">cfg_setnint</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *name, long int value, unsigned int index)</td></tr>
! 332:
! 333: <tr><td class="mdescLeft"> </td><td class="mdescRight">Set a value of an integer option given its name and index. <a href="#8b94a2e75abe7536ab9af8ee7c7c048b"></a><br></td></tr>
! 334: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT void __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#8b3d540078b83cbc91697eac952f2ad2">cfg_opt_setnfloat</a> (<a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *opt, double value, unsigned int index)</td></tr>
! 335:
! 336: <tr><td class="mdescLeft"> </td><td class="mdescRight">Set a value of a floating point option. <a href="#8b3d540078b83cbc91697eac952f2ad2"></a><br></td></tr>
! 337: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT void __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#07cc4870b50211627415d5945bf05211">cfg_setfloat</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *name, double value)</td></tr>
! 338:
! 339: <tr><td class="mdescLeft"> </td><td class="mdescRight">Set the value of a floating point option given its name. <a href="#07cc4870b50211627415d5945bf05211"></a><br></td></tr>
! 340: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT void __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#179cc35df34e6a51bd7e7a20e65478e1">cfg_setnfloat</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *name, double value, unsigned int index)</td></tr>
! 341:
! 342: <tr><td class="mdescLeft"> </td><td class="mdescRight">Set a value of a floating point option given its name and index. <a href="#179cc35df34e6a51bd7e7a20e65478e1"></a><br></td></tr>
! 343: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT void __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#e49271c4d9188f20ba2f507d14f8ed04">cfg_opt_setnbool</a> (<a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *opt, <a class="el" href="confuse_8h.html#4bce4b6aed9b07489d6a5c70321907e4">cfg_bool_t</a> value, unsigned int index)</td></tr>
! 344:
! 345: <tr><td class="mdescLeft"> </td><td class="mdescRight">Set a value of a boolean option. <a href="#e49271c4d9188f20ba2f507d14f8ed04"></a><br></td></tr>
! 346: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT void __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#0c3bcf2927802380238482e6fb09fd8e">cfg_setbool</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *name, <a class="el" href="confuse_8h.html#4bce4b6aed9b07489d6a5c70321907e4">cfg_bool_t</a> value)</td></tr>
! 347:
! 348: <tr><td class="mdescLeft"> </td><td class="mdescRight">Set the value of a boolean option given its name. <a href="#0c3bcf2927802380238482e6fb09fd8e"></a><br></td></tr>
! 349: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT void __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#38adad0d83e1a3d7b1f9b636e7de3bc7">cfg_setnbool</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *name, <a class="el" href="confuse_8h.html#4bce4b6aed9b07489d6a5c70321907e4">cfg_bool_t</a> value, unsigned int index)</td></tr>
! 350:
! 351: <tr><td class="mdescLeft"> </td><td class="mdescRight">Set a value of a boolean option given its name and index. <a href="#38adad0d83e1a3d7b1f9b636e7de3bc7"></a><br></td></tr>
! 352: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT void __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#6ea17369ab2edbe94c236894a5b9df23">cfg_opt_setnstr</a> (<a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *opt, const char *value, unsigned int index)</td></tr>
! 353:
! 354: <tr><td class="mdescLeft"> </td><td class="mdescRight">Set a value of a string option. <a href="#6ea17369ab2edbe94c236894a5b9df23"></a><br></td></tr>
! 355: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT void __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#dd02a10fac10c9b028c1438dff28343f">cfg_setstr</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *name, const char *value)</td></tr>
! 356:
! 357: <tr><td class="mdescLeft"> </td><td class="mdescRight">Set the value of a string option given its name. <a href="#dd02a10fac10c9b028c1438dff28343f"></a><br></td></tr>
! 358: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT void __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#cbbc5f4c7667fb2555be0c6d232f9f73">cfg_setnstr</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *name, const char *value, unsigned int index)</td></tr>
! 359:
! 360: <tr><td class="mdescLeft"> </td><td class="mdescRight">Set a value of a boolean option given its name and index. <a href="#cbbc5f4c7667fb2555be0c6d232f9f73"></a><br></td></tr>
! 361: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT void __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#15e2a938e67dc247b3e28a20c23d1ba6">cfg_setlist</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *name, unsigned int nvalues,...)</td></tr>
! 362:
! 363: <tr><td class="mdescLeft"> </td><td class="mdescRight">Set values for a list option. <a href="#15e2a938e67dc247b3e28a20c23d1ba6"></a><br></td></tr>
! 364: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT void __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#8ec7f5825bb59e983093675447a0f1eb">cfg_addlist</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *name, unsigned int nvalues,...)</td></tr>
! 365:
! 366: <tr><td class="mdescLeft"> </td><td class="mdescRight">Add values for a list option. <a href="#8ec7f5825bb59e983093675447a0f1eb"></a><br></td></tr>
! 367: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT void __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#6b04cb223e843bee362021dcce9e5cc8">cfg_opt_nprint_var</a> (<a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *opt, unsigned int index, FILE *fp)</td></tr>
! 368:
! 369: <tr><td class="mdescLeft"> </td><td class="mdescRight">Default value print function. <a href="#6b04cb223e843bee362021dcce9e5cc8"></a><br></td></tr>
! 370: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT void __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#7d764da177c6c53e8540b5416e09541f">cfg_opt_print_indent</a> (<a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *opt, FILE *fp, int indent)</td></tr>
! 371:
! 372: <tr><td class="mdescLeft"> </td><td class="mdescRight">Print an option and its value to a file. <a href="#7d764da177c6c53e8540b5416e09541f"></a><br></td></tr>
! 373: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT void __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#62f2b7c1ec02443315f43250c7a84728">cfg_opt_print</a> (<a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *opt, FILE *fp)</td></tr>
! 374:
! 375: <tr><td class="mdescLeft"> </td><td class="mdescRight">Print an option and its value to a file. <a href="#62f2b7c1ec02443315f43250c7a84728"></a><br></td></tr>
! 376: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT void __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#ac68b8ff7e5000071afdd4a8660aeb91">cfg_print_indent</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, FILE *fp, int indent)</td></tr>
! 377:
! 378: <tr><td class="mdescLeft"> </td><td class="mdescRight">Print the options and values to a file. <a href="#ac68b8ff7e5000071afdd4a8660aeb91"></a><br></td></tr>
! 379: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT void __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#f4254e5ea4b856c4072df8526de929b2">cfg_print</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, FILE *fp)</td></tr>
! 380:
! 381: <tr><td class="mdescLeft"> </td><td class="mdescRight">Print the options and values to a file. <a href="#f4254e5ea4b856c4072df8526de929b2"></a><br></td></tr>
! 382: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT <a class="el" href="confuse_8h.html#488182780ff16a94457f0d1242416154">cfg_print_func_t</a> __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#292ba236b86cbe1bec047a467c8d605d">cfg_opt_set_print_func</a> (<a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *opt, <a class="el" href="confuse_8h.html#488182780ff16a94457f0d1242416154">cfg_print_func_t</a> pf)</td></tr>
! 383:
! 384: <tr><td class="mdescLeft"> </td><td class="mdescRight">Set a print callback function for an option. <a href="#292ba236b86cbe1bec047a467c8d605d"></a><br></td></tr>
! 385: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT <a class="el" href="confuse_8h.html#488182780ff16a94457f0d1242416154">cfg_print_func_t</a> __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#03bdd2ac7828e5161e68da93cb07238d">cfg_set_print_func</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *name, <a class="el" href="confuse_8h.html#488182780ff16a94457f0d1242416154">cfg_print_func_t</a> pf)</td></tr>
! 386:
! 387: <tr><td class="mdescLeft"> </td><td class="mdescRight">Set a print callback function for an option given its name. <a href="#03bdd2ac7828e5161e68da93cb07238d"></a><br></td></tr>
! 388: <tr><td class="memItemLeft" nowrap align="right" valign="top">DLLIMPORT <br class="typebreak">
! 389: <a class="el" href="confuse_8h.html#4d01aba329210d110238d64d2047d502">cfg_validate_callback_t</a> <br class="typebreak">
! 390: __export </td><td class="memItemRight" valign="bottom"><a class="el" href="confuse_8h.html#8f07eca3c5e341ee6a81ecede2fbd5d8">cfg_set_validate_func</a> (<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *name, <a class="el" href="confuse_8h.html#4d01aba329210d110238d64d2047d502">cfg_validate_callback_t</a> vf)</td></tr>
! 391:
! 392: <tr><td class="mdescLeft"> </td><td class="mdescRight">Register a validating callback function for an option. <a href="#8f07eca3c5e341ee6a81ecede2fbd5d8"></a><br></td></tr>
! 393: </table>
! 394: <hr><a name="_details"></a><h2>Detailed Description</h2>
! 395: A configuration file parser library.
! 396: <p>
! 397: <hr><h2>Define Documentation</h2>
! 398: <a class="anchor" name="6b29dd8a4c6cd3d392d4ab6b2e535597"></a><!-- doxytag: member="confuse.h::CFG_END" ref="6b29dd8a4c6cd3d392d4ab6b2e535597" args="()" -->
! 399: <div class="memitem">
! 400: <div class="memproto">
! 401: <table class="memname">
! 402: <tr>
! 403: <td class="memname">#define CFG_END </td>
! 404: <td>(</td>
! 405: </td>
! 406: <td class="paramname"> </td>
! 407: <td> ) </td>
! 408: <td> {0,CFGT_NONE,0,0,CFGF_NONE,0,{0,0,cfg_false,0,0},0,0,0,0,0,0}</td>
! 409: </tr>
! 410: </table>
! 411: </div>
! 412: <div class="memdoc">
! 413:
! 414: <p>
! 415: Terminate list of options.
! 416: <p>
! 417: This must be the last initializer in the option list. <dl compact><dt><b>Examples: </b></dt><dd>
! 418: <a class="el" href="ftpconf_8c-example.html#a13">ftpconf.c</a>, <a class="el" href="reread_8c-example.html#a4">reread.c</a>, and <a class="el" href="simple_8c-example.html#a5">simple.c</a>.</dl>
! 419: </div>
! 420: </div><p>
! 421: <a class="anchor" name="b1ff85d6346cdefeb2ec2b696e50fde9"></a><!-- doxytag: member="confuse.h::CFG_FUNC" ref="b1ff85d6346cdefeb2ec2b696e50fde9" args="(name, func)" -->
! 422: <div class="memitem">
! 423: <div class="memproto">
! 424: <table class="memname">
! 425: <tr>
! 426: <td class="memname">#define CFG_FUNC </td>
! 427: <td>(</td>
! 428: <td class="paramtype">name, <tr>
! 429: <td class="paramkey"></td>
! 430: <td></td>
! 431: <td class="paramtype">func </td>
! 432: <td class="paramname"> </td>
! 433: <td> ) </td>
! 434: <td> {name,CFGT_FUNC,0,0,CFGF_NONE,0,{0,0,cfg_false,0,0},func,0,0,0,0,0}</td>
! 435: </tr>
! 436: </table>
! 437: </div>
! 438: <div class="memdoc">
! 439:
! 440: <p>
! 441: Initialize a function.
! 442: <p>
! 443: <dl compact><dt><b>Parameters:</b></dt><dd>
! 444: <table border="0" cellspacing="2" cellpadding="0">
! 445: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option </td></tr>
! 446: <tr><td valign="top"></td><td valign="top"><em>func</em> </td><td>The callback function.</td></tr>
! 447: </table>
! 448: </dl>
! 449: <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#f781d6e81a4dec706ae4d9848b26918d" title="Function prototype used by CFGT_FUNC options.">cfg_func_t</a> </dd></dl>
! 450: <dl compact><dt><b>Examples: </b></dt><dd>
! 451: <a class="el" href="ftpconf_8c-example.html#a18">ftpconf.c</a>.</dl>
! 452: </div>
! 453: </div><p>
! 454: <a class="anchor" name="240cd896d81e219b3acbcf8f7279ffbb"></a><!-- doxytag: member="confuse.h::CFG_PTR_CB" ref="240cd896d81e219b3acbcf8f7279ffbb" args="(name, def, flags, parsecb, freecb)" -->
! 455: <div class="memitem">
! 456: <div class="memproto">
! 457: <table class="memname">
! 458: <tr>
! 459: <td class="memname">#define CFG_PTR_CB </td>
! 460: <td>(</td>
! 461: <td class="paramtype">name, <tr>
! 462: <td class="paramkey"></td>
! 463: <td></td>
! 464: <td class="paramtype">def, <tr>
! 465: <td class="paramkey"></td>
! 466: <td></td>
! 467: <td class="paramtype">flags, <tr>
! 468: <td class="paramkey"></td>
! 469: <td></td>
! 470: <td class="paramtype">parsecb, <tr>
! 471: <td class="paramkey"></td>
! 472: <td></td>
! 473: <td class="paramtype">freecb </td>
! 474: <td class="paramname"> </td>
! 475: <td> ) </td>
! 476: <td> __CFG_PTR(name, def, flags, 0, parsecb, freecb)</td>
! 477: </tr>
! 478: </table>
! 479: </div>
! 480: <div class="memdoc">
! 481:
! 482: <p>
! 483: Initialize a user-defined option.
! 484: <p>
! 485: CFG_PTR options can only be used together with a value parsing callback.<p>
! 486: <dl compact><dt><b>Parameters:</b></dt><dd>
! 487: <table border="0" cellspacing="2" cellpadding="0">
! 488: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option </td></tr>
! 489: <tr><td valign="top"></td><td valign="top"><em>def</em> </td><td>Default value </td></tr>
! 490: <tr><td valign="top"></td><td valign="top"><em>flags</em> </td><td>Flags </td></tr>
! 491: <tr><td valign="top"></td><td valign="top"><em>parsecb</em> </td><td>Value parsing callback </td></tr>
! 492: <tr><td valign="top"></td><td valign="top"><em>freecb</em> </td><td>Memory release function</td></tr>
! 493: </table>
! 494: </dl>
! 495: <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#352a1a9074937ca131860891ed5c18c0" title="Value parsing callback prototype.">cfg_callback_t</a>, <a class="el" href="confuse_8h.html#a784e6c6702dedf1eb00fcfe0899ecab" title="User-defined memory release function for CFG_PTR values.">cfg_free_func_t</a> </dd></dl>
! 496:
! 497: </div>
! 498: </div><p>
! 499: <a class="anchor" name="043d5c79624269e5f60f59a698e461a6"></a><!-- doxytag: member="confuse.h::CFG_SEC" ref="043d5c79624269e5f60f59a698e461a6" args="(name, opts, flags)" -->
! 500: <div class="memitem">
! 501: <div class="memproto">
! 502: <table class="memname">
! 503: <tr>
! 504: <td class="memname">#define CFG_SEC </td>
! 505: <td>(</td>
! 506: <td class="paramtype">name, <tr>
! 507: <td class="paramkey"></td>
! 508: <td></td>
! 509: <td class="paramtype">opts, <tr>
! 510: <td class="paramkey"></td>
! 511: <td></td>
! 512: <td class="paramtype">flags </td>
! 513: <td class="paramname"> </td>
! 514: <td> ) </td>
! 515: <td> {name,CFGT_SEC,0,0,flags,opts,{0,0,cfg_false,0,0},0,0,0,0,0,0}</td>
! 516: </tr>
! 517: </table>
! 518: </div>
! 519: <div class="memdoc">
! 520:
! 521: <p>
! 522: Initialize a section.
! 523: <p>
! 524: <dl compact><dt><b>Parameters:</b></dt><dd>
! 525: <table border="0" cellspacing="2" cellpadding="0">
! 526: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option </td></tr>
! 527: <tr><td valign="top"></td><td valign="top"><em>opts</em> </td><td>Array of options that are valid within this section</td></tr>
! 528: <tr><td valign="top"></td><td valign="top"><em>flags</em> </td><td>Flags, specify CFGF_MULTI if it should be possible to have multiples of the same section, and CFGF_TITLE if the section(s) must have a title (which can be used in the <a class="el" href="confuse_8h.html#c1fda0e6937653d891ae276ae69d0f76" title="Return a section given the title, used for section with the CFGF_TITLE flag set.">cfg_gettsec()</a> function) </td></tr>
! 529: </table>
! 530: </dl>
! 531: <dl compact><dt><b>Examples: </b></dt><dd>
! 532: <a class="el" href="ftpconf_8c-example.html#a14">ftpconf.c</a>, and <a class="el" href="reread_8c-example.html#a6">reread.c</a>.</dl>
! 533: </div>
! 534: </div><p>
! 535: <a class="anchor" name="e54fbbc31bd8c7ec8d7f04597a9f749d"></a><!-- doxytag: member="confuse.h::CFG_SIMPLE_STR" ref="e54fbbc31bd8c7ec8d7f04597a9f749d" args="(name, svalue)" -->
! 536: <div class="memitem">
! 537: <div class="memproto">
! 538: <table class="memname">
! 539: <tr>
! 540: <td class="memname">#define CFG_SIMPLE_STR </td>
! 541: <td>(</td>
! 542: <td class="paramtype">name, <tr>
! 543: <td class="paramkey"></td>
! 544: <td></td>
! 545: <td class="paramtype">svalue </td>
! 546: <td class="paramname"> </td>
! 547: <td> ) </td>
! 548: <td> __CFG_STR(name, 0, CFGF_NONE, svalue, 0)</td>
! 549: </tr>
! 550: </table>
! 551: </div>
! 552: <div class="memdoc">
! 553:
! 554: <p>
! 555: Initialize a "simple" string option.
! 556: <p>
! 557: "Simple" options (in lack of a better expression) does not support lists of values or multiple sections. LibConfuse will store the value of a simple option in the user-defined location specified by the value parameter in the initializer. Simple options are not stored in the <a class="el" href="structcfg__t.html" title="Data structure holding information about a "section".">cfg_t</a> context, only a pointer. Sections can not be initialized as a "simple" option.<p>
! 558: As of version 2.2, libConfuse can now return the values of simple options with the cfg_get functions. This allows using the new cfg_print function with simple options.<p>
! 559: libConfuse doesn't support handling default values for "simple" options. They are assumed to be set by the calling application before cfg_parse is called.<p>
! 560: <dl compact><dt><b>Parameters:</b></dt><dd>
! 561: <table border="0" cellspacing="2" cellpadding="0">
! 562: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>name of the option </td></tr>
! 563: <tr><td valign="top"></td><td valign="top"><em>svalue</em> </td><td>pointer to a character pointer (a char **). This value must be initalized either to NULL or to a malloc()'ed string. You can't use <pre>
! 564: char *user = "joe";
! 565: ...
! 566: <a class="el" href="structcfg__opt__t.html" title="Data structure holding information about an option.">cfg_opt_t</a> opts[] = {
! 567: CFG_SIMPLE_STR("user", &user),
! 568: ...
! 569: </pre> since libConfuse will try to free the static string "joe" (which is an error) when a "user" option is found. Rather, use the following code snippet: <pre>
! 570: char *user = strdup("joe");
! 571: ...
! 572: <a class="el" href="structcfg__opt__t.html" title="Data structure holding information about an option.">cfg_opt_t</a> opts[] = {
! 573: CFG_SIMPLE_STR("user", &user),
! 574: ...
! 575: </pre> Alternatively, the default value can be set after the opts struct is defined, as in: <pre>
! 576: char *user = 0;
! 577: ...
! 578: <a class="el" href="structcfg__opt__t.html" title="Data structure holding information about an option.">cfg_opt_t</a> opts[] = {
! 579: CFG_SIMPLE_STR("user", &user),
! 580: ...
! 581: user = strdup("joe");
! 582: cfg = cfg_init(opts, 0);
! 583: cfg_parse(cfg, filename);
! 584: </pre> </td></tr>
! 585: </table>
! 586: </dl>
! 587: <dl compact><dt><b>Examples: </b></dt><dd>
! 588: <a class="el" href="simple_8c-example.html#a2">simple.c</a>.</dl>
! 589: </div>
! 590: </div><p>
! 591: <a class="anchor" name="66a1002180229809620b9bf2d3b888a6"></a><!-- doxytag: member="confuse.h::CFG_SUCCESS" ref="66a1002180229809620b9bf2d3b888a6" args="" -->
! 592: <div class="memitem">
! 593: <div class="memproto">
! 594: <table class="memname">
! 595: <tr>
! 596: <td class="memname">#define CFG_SUCCESS 0 </td>
! 597: </tr>
! 598: </table>
! 599: </div>
! 600: <div class="memdoc">
! 601:
! 602: <p>
! 603: Return codes from <a class="el" href="confuse_8h.html#0fca327466956c5580199e24397d49fe" title="Parse a configuration file.">cfg_parse()</a>.
! 604: <p>
! 605: <dl compact><dt><b>Examples: </b></dt><dd>
! 606: <a class="el" href="ftpconf_8c-example.html#a25">ftpconf.c</a>.</dl>
! 607: <p>Referenced by <a class="el" href="confuse_8c-source.html#l01073">cfg_parse_buf()</a>, and <a class="el" href="confuse_8c-source.html#l01038">cfg_parse_fp()</a>.</p>
! 608:
! 609: </div>
! 610: </div><p>
! 611: <a class="anchor" name="65df72d236bcc3e7f22c5b2b5c24bded"></a><!-- doxytag: member="confuse.h::CFGF_NONE" ref="65df72d236bcc3e7f22c5b2b5c24bded" args="" -->
! 612: <div class="memitem">
! 613: <div class="memproto">
! 614: <table class="memname">
! 615: <tr>
! 616: <td class="memname">#define CFGF_NONE 0 </td>
! 617: </tr>
! 618: </table>
! 619: </div>
! 620: <div class="memdoc">
! 621:
! 622: <p>
! 623: Flags.
! 624: <p>
! 625: <dl compact><dt><b>Examples: </b></dt><dd>
! 626: <a class="el" href="ftpconf_8c-example.html#a12">ftpconf.c</a>, and <a class="el" href="reread_8c-example.html#a3">reread.c</a>.</dl>
! 627: </div>
! 628: </div><p>
! 629: <hr><h2>Typedef Documentation</h2>
! 630: <a class="anchor" name="352a1a9074937ca131860891ed5c18c0"></a><!-- doxytag: member="confuse.h::cfg_callback_t" ref="352a1a9074937ca131860891ed5c18c0" args=")(cfg_t *cfg, cfg_opt_t *opt, const char *value, void *result)" -->
! 631: <div class="memitem">
! 632: <div class="memproto">
! 633: <table class="memname">
! 634: <tr>
! 635: <td class="memname">typedef int(* <a class="el" href="confuse_8h.html#352a1a9074937ca131860891ed5c18c0">cfg_callback_t</a>)(<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, <a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *opt, const char *value, void *result) </td>
! 636: </tr>
! 637: </table>
! 638: </div>
! 639: <div class="memdoc">
! 640:
! 641: <p>
! 642: Value parsing callback prototype.
! 643: <p>
! 644: This is a callback function (different from the one registered with the CFG_FUNC initializer) used to parse a value. This can be used to override the internal parsing of a value.<p>
! 645: Suppose you want an integer option that only can have certain values, for example 1, 2 and 3, and these should be written in the configuration file as "yes", "no" and "maybe". The callback function would be called with the found value ("yes", "no" or "maybe") as a string, and the result should be stored in the result parameter.<p>
! 646: <dl compact><dt><b>Parameters:</b></dt><dd>
! 647: <table border="0" cellspacing="2" cellpadding="0">
! 648: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 649: <tr><td valign="top"></td><td valign="top"><em>opt</em> </td><td>The option. </td></tr>
! 650: <tr><td valign="top"></td><td valign="top"><em>value</em> </td><td>The value found in the configuration file. </td></tr>
! 651: <tr><td valign="top"></td><td valign="top"><em>result</em> </td><td>Pointer to storage for the result, cast to a void pointer.</td></tr>
! 652: </table>
! 653: </dl>
! 654: <dl class="return" compact><dt><b>Returns:</b></dt><dd>On success, 0 should be returned. All other values indicates an error, and the parsing is aborted. The callback function should notify the error itself, for example by calling <a class="el" href="confuse_8h.html#5b448a145f12b67e90bd4e6bd387f129" title="Show a parser error.">cfg_error()</a>. </dd></dl>
! 655:
! 656: </div>
! 657: </div><p>
! 658: <a class="anchor" name="e4244b478d80a5ec06a1f5a46dd04fbe"></a><!-- doxytag: member="confuse.h::cfg_errfunc_t" ref="e4244b478d80a5ec06a1f5a46dd04fbe" args=")(cfg_t *cfg, const char *fmt, va_list ap)" -->
! 659: <div class="memitem">
! 660: <div class="memproto">
! 661: <table class="memname">
! 662: <tr>
! 663: <td class="memname">typedef void(* <a class="el" href="confuse_8h.html#e4244b478d80a5ec06a1f5a46dd04fbe">cfg_errfunc_t</a>)(<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, const char *fmt, va_list ap) </td>
! 664: </tr>
! 665: </table>
! 666: </div>
! 667: <div class="memdoc">
! 668:
! 669: <p>
! 670: Error reporting function.
! 671: <p>
! 672:
! 673: </div>
! 674: </div><p>
! 675: <a class="anchor" name="a784e6c6702dedf1eb00fcfe0899ecab"></a><!-- doxytag: member="confuse.h::cfg_free_func_t" ref="a784e6c6702dedf1eb00fcfe0899ecab" args=")(void *value)" -->
! 676: <div class="memitem">
! 677: <div class="memproto">
! 678: <table class="memname">
! 679: <tr>
! 680: <td class="memname">typedef void(* <a class="el" href="confuse_8h.html#a784e6c6702dedf1eb00fcfe0899ecab">cfg_free_func_t</a>)(void *value) </td>
! 681: </tr>
! 682: </table>
! 683: </div>
! 684: <div class="memdoc">
! 685:
! 686: <p>
! 687: User-defined memory release function for CFG_PTR values.
! 688: <p>
! 689: This callback is used to free memory allocated in a value parsing callback function. Especially useful for CFG_PTR options, since libConfuse will not itself release such values. If the values are simply allocated with a malloc(3), one can use the standard free(3) function here.
! 690: </div>
! 691: </div><p>
! 692: <a class="anchor" name="f781d6e81a4dec706ae4d9848b26918d"></a><!-- doxytag: member="confuse.h::cfg_func_t" ref="f781d6e81a4dec706ae4d9848b26918d" args=")(cfg_t *cfg, cfg_opt_t *opt, int argc, const char **argv)" -->
! 693: <div class="memitem">
! 694: <div class="memproto">
! 695: <table class="memname">
! 696: <tr>
! 697: <td class="memname">typedef int(* <a class="el" href="confuse_8h.html#f781d6e81a4dec706ae4d9848b26918d">cfg_func_t</a>)(<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, <a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *opt, int argc, const char **argv) </td>
! 698: </tr>
! 699: </table>
! 700: </div>
! 701: <div class="memdoc">
! 702:
! 703: <p>
! 704: Function prototype used by CFGT_FUNC options.
! 705: <p>
! 706: This is a callback function, registered with the CFG_FUNC initializer. Each time libConfuse finds a function, the registered callback function is called (parameters are passed as strings, any conversion to other types should be made in the callback function). libConfuse does not support any storage of the data found; these are passed as parameters to the callback, and it's the responsibility of the callback function to do whatever it should do with the data.<p>
! 707: <dl compact><dt><b>Parameters:</b></dt><dd>
! 708: <table border="0" cellspacing="2" cellpadding="0">
! 709: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 710: <tr><td valign="top"></td><td valign="top"><em>opt</em> </td><td>The option. </td></tr>
! 711: <tr><td valign="top"></td><td valign="top"><em>argc</em> </td><td>Number of arguments passed. The callback function is responsible for checking that the correct number of arguments are passed. </td></tr>
! 712: <tr><td valign="top"></td><td valign="top"><em>argv</em> </td><td>Arguments as an array of character strings.</td></tr>
! 713: </table>
! 714: </dl>
! 715: <dl class="return" compact><dt><b>Returns:</b></dt><dd>On success, 0 should be returned. All other values indicates an error, and the parsing is aborted. The callback function should notify the error itself, for example by calling <a class="el" href="confuse_8h.html#5b448a145f12b67e90bd4e6bd387f129" title="Show a parser error.">cfg_error()</a>.</dd></dl>
! 716: <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#b1ff85d6346cdefeb2ec2b696e50fde9" title="Initialize a function.">CFG_FUNC</a> </dd></dl>
! 717:
! 718: </div>
! 719: </div><p>
! 720: <a class="anchor" name="488182780ff16a94457f0d1242416154"></a><!-- doxytag: member="confuse.h::cfg_print_func_t" ref="488182780ff16a94457f0d1242416154" args=")(cfg_opt_t *opt, unsigned int index, FILE *fp)" -->
! 721: <div class="memitem">
! 722: <div class="memproto">
! 723: <table class="memname">
! 724: <tr>
! 725: <td class="memname">typedef void(* <a class="el" href="confuse_8h.html#488182780ff16a94457f0d1242416154">cfg_print_func_t</a>)(<a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *opt, unsigned int index, FILE *fp) </td>
! 726: </tr>
! 727: </table>
! 728: </div>
! 729: <div class="memdoc">
! 730:
! 731: <p>
! 732: Function prototype used by the cfg_print_ functions.
! 733: <p>
! 734: This callback function is used to print option values. For options with a value parsing callback, this is often required, especially if a string is mapped to an integer by the callback. This print callback must then map the integer back to the appropriate string.<p>
! 735: Except for functions, the print callback function should only print the value of the option, not the name and the equal sign (that is handled by the cfg_opt_print function). For function options however, the name and the parenthesis must be printed by this function. The value to print can be accessed with the cfg_opt_get functions.<p>
! 736: <dl compact><dt><b>Parameters:</b></dt><dd>
! 737: <table border="0" cellspacing="2" cellpadding="0">
! 738: <tr><td valign="top"></td><td valign="top"><em>opt</em> </td><td>The option structure (eg, as returned from <a class="el" href="confuse_8h.html#33f48558624569678272f46925ead40f" title="Return an option given it's name.">cfg_getopt()</a>) </td></tr>
! 739: <tr><td valign="top"></td><td valign="top"><em>index</em> </td><td>Index of the value to get. Zero based. </td></tr>
! 740: <tr><td valign="top"></td><td valign="top"><em>fp</em> </td><td>File stream to print to, use stdout to print to the screen.</td></tr>
! 741: </table>
! 742: </dl>
! 743: <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#f4254e5ea4b856c4072df8526de929b2" title="Print the options and values to a file.">cfg_print</a>, <a class="el" href="confuse_8h.html#03bdd2ac7828e5161e68da93cb07238d" title="Set a print callback function for an option given its name.">cfg_set_print_func</a> </dd></dl>
! 744:
! 745: </div>
! 746: </div><p>
! 747: <a class="anchor" name="4d01aba329210d110238d64d2047d502"></a><!-- doxytag: member="confuse.h::cfg_validate_callback_t" ref="4d01aba329210d110238d64d2047d502" args=")(cfg_t *cfg, cfg_opt_t *opt)" -->
! 748: <div class="memitem">
! 749: <div class="memproto">
! 750: <table class="memname">
! 751: <tr>
! 752: <td class="memname">typedef int(* <a class="el" href="confuse_8h.html#4d01aba329210d110238d64d2047d502">cfg_validate_callback_t</a>)(<a class="el" href="structcfg__t.html">cfg_t</a> *cfg, <a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> *opt) </td>
! 753: </tr>
! 754: </table>
! 755: </div>
! 756: <div class="memdoc">
! 757:
! 758: <p>
! 759: Validating callback prototype.
! 760: <p>
! 761: This callback function is called after an option has been parsed and set. The function is called for both fundamental values (strings, integers etc) as well as lists and sections. This can for example be used to validate that all required options in a section has been set to sane values.<p>
! 762: <dl class="return" compact><dt><b>Returns:</b></dt><dd>On success, 0 should be returned. All other values indicates an error, and the parsing is aborted. The callback function should notify the error itself, for example by calling <a class="el" href="confuse_8h.html#5b448a145f12b67e90bd4e6bd387f129" title="Show a parser error.">cfg_error()</a>.</dd></dl>
! 763: <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#8f07eca3c5e341ee6a81ecede2fbd5d8" title="Register a validating callback function for an option.">cfg_set_validate_func</a> </dd></dl>
! 764:
! 765: </div>
! 766: </div><p>
! 767: <hr><h2>Enumeration Type Documentation</h2>
! 768: <a class="anchor" name="4bce4b6aed9b07489d6a5c70321907e4"></a><!-- doxytag: member="confuse.h::cfg_bool_t" ref="4bce4b6aed9b07489d6a5c70321907e4" args="" -->
! 769: <div class="memitem">
! 770: <div class="memproto">
! 771: <table class="memname">
! 772: <tr>
! 773: <td class="memname">enum <a class="el" href="confuse_8h.html#4bce4b6aed9b07489d6a5c70321907e4">cfg_bool_t</a> </td>
! 774: </tr>
! 775: </table>
! 776: </div>
! 777: <div class="memdoc">
! 778:
! 779: <p>
! 780: Boolean values.
! 781: <p>
! 782:
! 783: </div>
! 784: </div><p>
! 785: <a class="anchor" name="9c62155b0deae0e1831507520a2ff7c7"></a><!-- doxytag: member="confuse.h::cfg_type_t" ref="9c62155b0deae0e1831507520a2ff7c7" args="" -->
! 786: <div class="memitem">
! 787: <div class="memproto">
! 788: <table class="memname">
! 789: <tr>
! 790: <td class="memname">enum <a class="el" href="confuse_8h.html#9c62155b0deae0e1831507520a2ff7c7">cfg_type_t</a> </td>
! 791: </tr>
! 792: </table>
! 793: </div>
! 794: <div class="memdoc">
! 795:
! 796: <p>
! 797: Fundamental option types.
! 798: <p>
! 799: <dl compact><dt><b>Enumerator: </b></dt><dd>
! 800: <table border="0" cellspacing="2" cellpadding="0">
! 801: <tr><td valign="top"><em><a class="anchor" name="9c62155b0deae0e1831507520a2ff7c7f397ec05171bfacd9944b3d538fbd6dc"></a><!-- doxytag: member="CFGT_INT" ref="9c62155b0deae0e1831507520a2ff7c7f397ec05171bfacd9944b3d538fbd6dc" args="" -->CFGT_INT</em> </td><td>
! 802: integer </td></tr>
! 803: <tr><td valign="top"><em><a class="anchor" name="9c62155b0deae0e1831507520a2ff7c7bd237f20c366857f5521da911ba813cb"></a><!-- doxytag: member="CFGT_FLOAT" ref="9c62155b0deae0e1831507520a2ff7c7bd237f20c366857f5521da911ba813cb" args="" -->CFGT_FLOAT</em> </td><td>
! 804: floating point number </td></tr>
! 805: <tr><td valign="top"><em><a class="anchor" name="9c62155b0deae0e1831507520a2ff7c7c6a18c97187c38648e11f18ad465f4f3"></a><!-- doxytag: member="CFGT_STR" ref="9c62155b0deae0e1831507520a2ff7c7c6a18c97187c38648e11f18ad465f4f3" args="" -->CFGT_STR</em> </td><td>
! 806: string </td></tr>
! 807: <tr><td valign="top"><em><a class="anchor" name="9c62155b0deae0e1831507520a2ff7c78f04ccea50fbe06f9a118b4423ead6fd"></a><!-- doxytag: member="CFGT_BOOL" ref="9c62155b0deae0e1831507520a2ff7c78f04ccea50fbe06f9a118b4423ead6fd" args="" -->CFGT_BOOL</em> </td><td>
! 808: boolean value </td></tr>
! 809: <tr><td valign="top"><em><a class="anchor" name="9c62155b0deae0e1831507520a2ff7c7a786f6288e70d0ec5fc0ef38f1671f1b"></a><!-- doxytag: member="CFGT_SEC" ref="9c62155b0deae0e1831507520a2ff7c7a786f6288e70d0ec5fc0ef38f1671f1b" args="" -->CFGT_SEC</em> </td><td>
! 810: section </td></tr>
! 811: <tr><td valign="top"><em><a class="anchor" name="9c62155b0deae0e1831507520a2ff7c7531bc0d05779dd0fbbe90ac9ae744c0f"></a><!-- doxytag: member="CFGT_FUNC" ref="9c62155b0deae0e1831507520a2ff7c7531bc0d05779dd0fbbe90ac9ae744c0f" args="" -->CFGT_FUNC</em> </td><td>
! 812: function </td></tr>
! 813: <tr><td valign="top"><em><a class="anchor" name="9c62155b0deae0e1831507520a2ff7c71b2260acd1f600d08b1317676b90dbb4"></a><!-- doxytag: member="CFGT_PTR" ref="9c62155b0deae0e1831507520a2ff7c71b2260acd1f600d08b1317676b90dbb4" args="" -->CFGT_PTR</em> </td><td>
! 814: pointer to user-defined value </td></tr>
! 815: </table>
! 816: </dl>
! 817:
! 818: </div>
! 819: </div><p>
! 820: <hr><h2>Function Documentation</h2>
! 821: <a class="anchor" name="8ec7f5825bb59e983093675447a0f1eb"></a><!-- doxytag: member="confuse.h::cfg_addlist" ref="8ec7f5825bb59e983093675447a0f1eb" args="(cfg_t *cfg, const char *name, unsigned int nvalues,...)" -->
! 822: <div class="memitem">
! 823: <div class="memproto">
! 824: <table class="memname">
! 825: <tr>
! 826: <td class="memname">DLLIMPORT void __export cfg_addlist </td>
! 827: <td>(</td>
! 828: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 829: <td class="paramname"> <em>cfg</em>, </td>
! 830: </tr>
! 831: <tr>
! 832: <td class="paramkey"></td>
! 833: <td></td>
! 834: <td class="paramtype">const char * </td>
! 835: <td class="paramname"> <em>name</em>, </td>
! 836: </tr>
! 837: <tr>
! 838: <td class="paramkey"></td>
! 839: <td></td>
! 840: <td class="paramtype">unsigned int </td>
! 841: <td class="paramname"> <em>nvalues</em>, </td>
! 842: </tr>
! 843: <tr>
! 844: <td class="paramkey"></td>
! 845: <td></td>
! 846: <td class="paramtype"> </td>
! 847: <td class="paramname"> <em>...</em></td><td> </td>
! 848: </tr>
! 849: <tr>
! 850: <td></td>
! 851: <td>)</td>
! 852: <td></td><td></td><td></td>
! 853: </tr>
! 854: </table>
! 855: </div>
! 856: <div class="memdoc">
! 857:
! 858: <p>
! 859: Add values for a list option.
! 860: <p>
! 861: The new values are appended to any current values in the list.<p>
! 862: <dl compact><dt><b>Parameters:</b></dt><dd>
! 863: <table border="0" cellspacing="2" cellpadding="0">
! 864: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 865: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option. </td></tr>
! 866: <tr><td valign="top"></td><td valign="top"><em>nvalues</em> </td><td>Number of values to add. </td></tr>
! 867: <tr><td valign="top"></td><td valign="top"><em>...</em> </td><td>The values to add, the type must match the type of the option and the number of values must be equal to the nvalues parameter. </td></tr>
! 868: </table>
! 869: </dl>
! 870:
! 871: <p>References <a class="el" href="confuse_8h-source.html#l00083">CFGF_LIST</a>, and <a class="el" href="confuse_8h-source.html#l00262">cfg_opt_t::flags</a>.</p>
! 872:
! 873: </div>
! 874: </div><p>
! 875: <a class="anchor" name="5b448a145f12b67e90bd4e6bd387f129"></a><!-- doxytag: member="confuse.h::cfg_error" ref="5b448a145f12b67e90bd4e6bd387f129" args="(cfg_t *cfg, const char *fmt,...)" -->
! 876: <div class="memitem">
! 877: <div class="memproto">
! 878: <table class="memname">
! 879: <tr>
! 880: <td class="memname">DLLIMPORT void __export cfg_error </td>
! 881: <td>(</td>
! 882: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 883: <td class="paramname"> <em>cfg</em>, </td>
! 884: </tr>
! 885: <tr>
! 886: <td class="paramkey"></td>
! 887: <td></td>
! 888: <td class="paramtype">const char * </td>
! 889: <td class="paramname"> <em>fmt</em>, </td>
! 890: </tr>
! 891: <tr>
! 892: <td class="paramkey"></td>
! 893: <td></td>
! 894: <td class="paramtype"> </td>
! 895: <td class="paramname"> <em>...</em></td><td> </td>
! 896: </tr>
! 897: <tr>
! 898: <td></td>
! 899: <td>)</td>
! 900: <td></td><td></td><td></td>
! 901: </tr>
! 902: </table>
! 903: </div>
! 904: <div class="memdoc">
! 905:
! 906: <p>
! 907: Show a parser error.
! 908: <p>
! 909: Any user-defined error reporting function is called. <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#e5cd3df98ec4c9895fbe73fd1c32f7a1" title="Install a user-defined error reporting function.">cfg_set_error_function</a> </dd></dl>
! 910: <dl compact><dt><b>Examples: </b></dt><dd>
! 911: <a class="el" href="ftpconf_8c-example.html#a2">ftpconf.c</a>.</dl>
! 912: <p>References <a class="el" href="confuse_8h-source.html#l00224">cfg_t::errfunc</a>, <a class="el" href="confuse_8h-source.html#l00222">cfg_t::filename</a>, and <a class="el" href="confuse_8h-source.html#l00223">cfg_t::line</a>.</p>
! 913:
! 914: </div>
! 915: </div><p>
! 916: <a class="anchor" name="0601a1513882caf574ea91a2177bdfdb"></a><!-- doxytag: member="confuse.h::cfg_free" ref="0601a1513882caf574ea91a2177bdfdb" args="(cfg_t *cfg)" -->
! 917: <div class="memitem">
! 918: <div class="memproto">
! 919: <table class="memname">
! 920: <tr>
! 921: <td class="memname">DLLIMPORT void __export cfg_free </td>
! 922: <td>(</td>
! 923: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 924: <td class="paramname"> <em>cfg</em> </td>
! 925: <td> ) </td>
! 926: <td></td>
! 927: </tr>
! 928: </table>
! 929: </div>
! 930: <div class="memdoc">
! 931:
! 932: <p>
! 933: Free a <a class="el" href="structcfg__t.html" title="Data structure holding information about a "section".">cfg_t</a> context.
! 934: <p>
! 935: All memory allocated by the <a class="el" href="structcfg__t.html" title="Data structure holding information about a "section".">cfg_t</a> context structure are freed, and can't be used in any further cfg_* calls. <dl compact><dt><b>Examples: </b></dt><dd>
! 936: <a class="el" href="ftpconf_8c-example.html#a31">ftpconf.c</a>, <a class="el" href="reread_8c-example.html#a9">reread.c</a>, and <a class="el" href="simple_8c-example.html#a11">simple.c</a>.</dl>
! 937: <p>References <a class="el" href="confuse_8h-source.html#l00222">cfg_t::filename</a>, <a class="el" href="confuse_8h-source.html#l00216">cfg_t::name</a>, <a class="el" href="confuse_8h-source.html#l00258">cfg_opt_t::name</a>, <a class="el" href="confuse_8h-source.html#l00219">cfg_t::opts</a>, and <a class="el" href="confuse_8h-source.html#l00220">cfg_t::title</a>.</p>
! 938:
! 939: </div>
! 940: </div><p>
! 941: <a class="anchor" name="f6003c72a220f36cdecd3a14bd2285cc"></a><!-- doxytag: member="confuse.h::cfg_free_value" ref="f6003c72a220f36cdecd3a14bd2285cc" args="(cfg_opt_t *opt)" -->
! 942: <div class="memitem">
! 943: <div class="memproto">
! 944: <table class="memname">
! 945: <tr>
! 946: <td class="memname">DLLIMPORT void __export cfg_free_value </td>
! 947: <td>(</td>
! 948: <td class="paramtype"><a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> * </td>
! 949: <td class="paramname"> <em>opt</em> </td>
! 950: <td> ) </td>
! 951: <td></td>
! 952: </tr>
! 953: </table>
! 954: </div>
! 955: <div class="memdoc">
! 956:
! 957: <p>
! 958: Free the memory allocated for the values of a given option.
! 959: <p>
! 960: Only the values are freed, not the option itself (it is freed by <a class="el" href="confuse_8h.html#0601a1513882caf574ea91a2177bdfdb" title="Free a cfg_t context.">cfg_free()</a>).<p>
! 961: <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#0601a1513882caf574ea91a2177bdfdb" title="Free a cfg_t context.">cfg_free()</a> </dd></dl>
! 962:
! 963: <p>References <a class="el" href="confuse_8h-source.html#l00076">CFGT_PTR</a>, <a class="el" href="confuse_8h-source.html#l00074">CFGT_SEC</a>, <a class="el" href="confuse_8h-source.html#l00072">CFGT_STR</a>, <a class="el" href="confuse_8h-source.html#l00272">cfg_opt_t::freecb</a>, <a class="el" href="confuse_8h-source.html#l00260">cfg_opt_t::nvalues</a>, <a class="el" href="confuse_8h-source.html#l00237">cfg_value_t::ptr</a>, <a class="el" href="confuse_8h-source.html#l00236">cfg_value_t::section</a>, <a class="el" href="confuse_8h-source.html#l00235">cfg_value_t::string</a>, <a class="el" href="confuse_8h-source.html#l00259">cfg_opt_t::type</a>, and <a class="el" href="confuse_8h-source.html#l00261">cfg_opt_t::values</a>.</p>
! 964:
! 965: </div>
! 966: </div><p>
! 967: <a class="anchor" name="b4903f75c29f9c2973696039c4f5c0df"></a><!-- doxytag: member="confuse.h::cfg_getbool" ref="b4903f75c29f9c2973696039c4f5c0df" args="(cfg_t *cfg, const char *name)" -->
! 968: <div class="memitem">
! 969: <div class="memproto">
! 970: <table class="memname">
! 971: <tr>
! 972: <td class="memname">DLLIMPORT <a class="el" href="confuse_8h.html#4bce4b6aed9b07489d6a5c70321907e4">cfg_bool_t</a> __export cfg_getbool </td>
! 973: <td>(</td>
! 974: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 975: <td class="paramname"> <em>cfg</em>, </td>
! 976: </tr>
! 977: <tr>
! 978: <td class="paramkey"></td>
! 979: <td></td>
! 980: <td class="paramtype">const char * </td>
! 981: <td class="paramname"> <em>name</em></td><td> </td>
! 982: </tr>
! 983: <tr>
! 984: <td></td>
! 985: <td>)</td>
! 986: <td></td><td></td><td></td>
! 987: </tr>
! 988: </table>
! 989: </div>
! 990: <div class="memdoc">
! 991:
! 992: <p>
! 993: Returns the value of a boolean option.
! 994: <p>
! 995: <dl compact><dt><b>Parameters:</b></dt><dd>
! 996: <table border="0" cellspacing="2" cellpadding="0">
! 997: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 998: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option. </td></tr>
! 999: </table>
! 1000: </dl>
! 1001: <dl class="return" compact><dt><b>Returns:</b></dt><dd>The requested value is returned. If the option was not set in the configuration file, the default value given in the corresponding <a class="el" href="structcfg__opt__t.html" title="Data structure holding information about an option.">cfg_opt_t</a> structure is returned. It is an error to try to get an option that isn't declared. </dd></dl>
! 1002: <dl compact><dt><b>Examples: </b></dt><dd>
! 1003: <a class="el" href="ftpconf_8c-example.html#a26">ftpconf.c</a>.</dl>
! 1004: </div>
! 1005: </div><p>
! 1006: <a class="anchor" name="40e3d18ed9fbf5eae90aec58d68cb474"></a><!-- doxytag: member="confuse.h::cfg_getfloat" ref="40e3d18ed9fbf5eae90aec58d68cb474" args="(cfg_t *cfg, const char *name)" -->
! 1007: <div class="memitem">
! 1008: <div class="memproto">
! 1009: <table class="memname">
! 1010: <tr>
! 1011: <td class="memname">DLLIMPORT double __export cfg_getfloat </td>
! 1012: <td>(</td>
! 1013: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 1014: <td class="paramname"> <em>cfg</em>, </td>
! 1015: </tr>
! 1016: <tr>
! 1017: <td class="paramkey"></td>
! 1018: <td></td>
! 1019: <td class="paramtype">const char * </td>
! 1020: <td class="paramname"> <em>name</em></td><td> </td>
! 1021: </tr>
! 1022: <tr>
! 1023: <td></td>
! 1024: <td>)</td>
! 1025: <td></td><td></td><td></td>
! 1026: </tr>
! 1027: </table>
! 1028: </div>
! 1029: <div class="memdoc">
! 1030:
! 1031: <p>
! 1032: Returns the value of a floating point option.
! 1033: <p>
! 1034: <dl compact><dt><b>Parameters:</b></dt><dd>
! 1035: <table border="0" cellspacing="2" cellpadding="0">
! 1036: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 1037: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option. </td></tr>
! 1038: </table>
! 1039: </dl>
! 1040: <dl class="return" compact><dt><b>Returns:</b></dt><dd>The requested value is returned. If the option was not set in the configuration file, the default value given in the corresponding <a class="el" href="structcfg__opt__t.html" title="Data structure holding information about an option.">cfg_opt_t</a> structure is returned. It is an error to try to get an option that isn't declared. </dd></dl>
! 1041:
! 1042: </div>
! 1043: </div><p>
! 1044: <a class="anchor" name="aa50eb2942ae8e7cb7f9ccbfe002b3cd"></a><!-- doxytag: member="confuse.h::cfg_getint" ref="aa50eb2942ae8e7cb7f9ccbfe002b3cd" args="(cfg_t *cfg, const char *name)" -->
! 1045: <div class="memitem">
! 1046: <div class="memproto">
! 1047: <table class="memname">
! 1048: <tr>
! 1049: <td class="memname">DLLIMPORT long int __export cfg_getint </td>
! 1050: <td>(</td>
! 1051: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 1052: <td class="paramname"> <em>cfg</em>, </td>
! 1053: </tr>
! 1054: <tr>
! 1055: <td class="paramkey"></td>
! 1056: <td></td>
! 1057: <td class="paramtype">const char * </td>
! 1058: <td class="paramname"> <em>name</em></td><td> </td>
! 1059: </tr>
! 1060: <tr>
! 1061: <td></td>
! 1062: <td>)</td>
! 1063: <td></td><td></td><td></td>
! 1064: </tr>
! 1065: </table>
! 1066: </div>
! 1067: <div class="memdoc">
! 1068:
! 1069: <p>
! 1070: Returns the value of an integer option.
! 1071: <p>
! 1072: This is the same as calling cfg_getnint with index 0. <dl compact><dt><b>Parameters:</b></dt><dd>
! 1073: <table border="0" cellspacing="2" cellpadding="0">
! 1074: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 1075: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option. </td></tr>
! 1076: </table>
! 1077: </dl>
! 1078: <dl class="return" compact><dt><b>Returns:</b></dt><dd>The requested value is returned. If the option was not set in the configuration file, the default value given in the corresponding <a class="el" href="structcfg__opt__t.html" title="Data structure holding information about an option.">cfg_opt_t</a> structure is returned. It is an error to try to get an option that isn't declared. </dd></dl>
! 1079: <dl compact><dt><b>Examples: </b></dt><dd>
! 1080: <a class="el" href="ftpconf_8c-example.html#a29">ftpconf.c</a>, and <a class="el" href="reread_8c-example.html#a16">reread.c</a>.</dl>
! 1081: </div>
! 1082: </div><p>
! 1083: <a class="anchor" name="8984944ec9de3a67e3007bfba32f2127"></a><!-- doxytag: member="confuse.h::cfg_getnbool" ref="8984944ec9de3a67e3007bfba32f2127" args="(cfg_t *cfg, const char *name, unsigned int index)" -->
! 1084: <div class="memitem">
! 1085: <div class="memproto">
! 1086: <table class="memname">
! 1087: <tr>
! 1088: <td class="memname">DLLIMPORT <a class="el" href="confuse_8h.html#4bce4b6aed9b07489d6a5c70321907e4">cfg_bool_t</a> __export cfg_getnbool </td>
! 1089: <td>(</td>
! 1090: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 1091: <td class="paramname"> <em>cfg</em>, </td>
! 1092: </tr>
! 1093: <tr>
! 1094: <td class="paramkey"></td>
! 1095: <td></td>
! 1096: <td class="paramtype">const char * </td>
! 1097: <td class="paramname"> <em>name</em>, </td>
! 1098: </tr>
! 1099: <tr>
! 1100: <td class="paramkey"></td>
! 1101: <td></td>
! 1102: <td class="paramtype">unsigned int </td>
! 1103: <td class="paramname"> <em>index</em></td><td> </td>
! 1104: </tr>
! 1105: <tr>
! 1106: <td></td>
! 1107: <td>)</td>
! 1108: <td></td><td></td><td></td>
! 1109: </tr>
! 1110: </table>
! 1111: </div>
! 1112: <div class="memdoc">
! 1113:
! 1114: <p>
! 1115: Indexed version of <a class="el" href="confuse_8h.html#b4903f75c29f9c2973696039c4f5c0df" title="Returns the value of a boolean option.">cfg_getbool()</a>, used for lists.
! 1116: <p>
! 1117: <dl compact><dt><b>Parameters:</b></dt><dd>
! 1118: <table border="0" cellspacing="2" cellpadding="0">
! 1119: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 1120: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option. </td></tr>
! 1121: <tr><td valign="top"></td><td valign="top"><em>index</em> </td><td>Index of the value to get. Zero based. </td></tr>
! 1122: </table>
! 1123: </dl>
! 1124: <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#b4903f75c29f9c2973696039c4f5c0df" title="Returns the value of a boolean option.">cfg_getbool</a> </dd></dl>
! 1125:
! 1126: </div>
! 1127: </div><p>
! 1128: <a class="anchor" name="af63837150498ce6ecd530a9769f9e43"></a><!-- doxytag: member="confuse.h::cfg_getnfloat" ref="af63837150498ce6ecd530a9769f9e43" args="(cfg_t *cfg, const char *name, unsigned int index)" -->
! 1129: <div class="memitem">
! 1130: <div class="memproto">
! 1131: <table class="memname">
! 1132: <tr>
! 1133: <td class="memname">DLLIMPORT double __export cfg_getnfloat </td>
! 1134: <td>(</td>
! 1135: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 1136: <td class="paramname"> <em>cfg</em>, </td>
! 1137: </tr>
! 1138: <tr>
! 1139: <td class="paramkey"></td>
! 1140: <td></td>
! 1141: <td class="paramtype">const char * </td>
! 1142: <td class="paramname"> <em>name</em>, </td>
! 1143: </tr>
! 1144: <tr>
! 1145: <td class="paramkey"></td>
! 1146: <td></td>
! 1147: <td class="paramtype">unsigned int </td>
! 1148: <td class="paramname"> <em>index</em></td><td> </td>
! 1149: </tr>
! 1150: <tr>
! 1151: <td></td>
! 1152: <td>)</td>
! 1153: <td></td><td></td><td></td>
! 1154: </tr>
! 1155: </table>
! 1156: </div>
! 1157: <div class="memdoc">
! 1158:
! 1159: <p>
! 1160: Indexed version of <a class="el" href="confuse_8h.html#40e3d18ed9fbf5eae90aec58d68cb474" title="Returns the value of a floating point option.">cfg_getfloat()</a>, used for lists.
! 1161: <p>
! 1162: <dl compact><dt><b>Parameters:</b></dt><dd>
! 1163: <table border="0" cellspacing="2" cellpadding="0">
! 1164: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 1165: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option. </td></tr>
! 1166: <tr><td valign="top"></td><td valign="top"><em>index</em> </td><td>Index of the value to get. Zero based. </td></tr>
! 1167: </table>
! 1168: </dl>
! 1169: <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#40e3d18ed9fbf5eae90aec58d68cb474" title="Returns the value of a floating point option.">cfg_getfloat</a> </dd></dl>
! 1170:
! 1171: </div>
! 1172: </div><p>
! 1173: <a class="anchor" name="ddba63989fbf548cb0365ce875f138d4"></a><!-- doxytag: member="confuse.h::cfg_getnint" ref="ddba63989fbf548cb0365ce875f138d4" args="(cfg_t *cfg, const char *name, unsigned int index)" -->
! 1174: <div class="memitem">
! 1175: <div class="memproto">
! 1176: <table class="memname">
! 1177: <tr>
! 1178: <td class="memname">DLLIMPORT long int __export cfg_getnint </td>
! 1179: <td>(</td>
! 1180: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 1181: <td class="paramname"> <em>cfg</em>, </td>
! 1182: </tr>
! 1183: <tr>
! 1184: <td class="paramkey"></td>
! 1185: <td></td>
! 1186: <td class="paramtype">const char * </td>
! 1187: <td class="paramname"> <em>name</em>, </td>
! 1188: </tr>
! 1189: <tr>
! 1190: <td class="paramkey"></td>
! 1191: <td></td>
! 1192: <td class="paramtype">unsigned int </td>
! 1193: <td class="paramname"> <em>index</em></td><td> </td>
! 1194: </tr>
! 1195: <tr>
! 1196: <td></td>
! 1197: <td>)</td>
! 1198: <td></td><td></td><td></td>
! 1199: </tr>
! 1200: </table>
! 1201: </div>
! 1202: <div class="memdoc">
! 1203:
! 1204: <p>
! 1205: Indexed version of <a class="el" href="confuse_8h.html#aa50eb2942ae8e7cb7f9ccbfe002b3cd" title="Returns the value of an integer option.">cfg_getint()</a>, used for lists.
! 1206: <p>
! 1207: <dl compact><dt><b>Parameters:</b></dt><dd>
! 1208: <table border="0" cellspacing="2" cellpadding="0">
! 1209: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 1210: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option. </td></tr>
! 1211: <tr><td valign="top"></td><td valign="top"><em>index</em> </td><td>Index of the value to get. Zero based. </td></tr>
! 1212: </table>
! 1213: </dl>
! 1214: <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#aa50eb2942ae8e7cb7f9ccbfe002b3cd" title="Returns the value of an integer option.">cfg_getint</a> </dd></dl>
! 1215:
! 1216: </div>
! 1217: </div><p>
! 1218: <a class="anchor" name="d5e8eea765588892053b73eed4017edd"></a><!-- doxytag: member="confuse.h::cfg_getnsec" ref="d5e8eea765588892053b73eed4017edd" args="(cfg_t *cfg, const char *name, unsigned int index)" -->
! 1219: <div class="memitem">
! 1220: <div class="memproto">
! 1221: <table class="memname">
! 1222: <tr>
! 1223: <td class="memname">DLLIMPORT <a class="el" href="structcfg__t.html">cfg_t</a>* __export cfg_getnsec </td>
! 1224: <td>(</td>
! 1225: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 1226: <td class="paramname"> <em>cfg</em>, </td>
! 1227: </tr>
! 1228: <tr>
! 1229: <td class="paramkey"></td>
! 1230: <td></td>
! 1231: <td class="paramtype">const char * </td>
! 1232: <td class="paramname"> <em>name</em>, </td>
! 1233: </tr>
! 1234: <tr>
! 1235: <td class="paramkey"></td>
! 1236: <td></td>
! 1237: <td class="paramtype">unsigned int </td>
! 1238: <td class="paramname"> <em>index</em></td><td> </td>
! 1239: </tr>
! 1240: <tr>
! 1241: <td></td>
! 1242: <td>)</td>
! 1243: <td></td><td></td><td></td>
! 1244: </tr>
! 1245: </table>
! 1246: </div>
! 1247: <div class="memdoc">
! 1248:
! 1249: <p>
! 1250: Indexed version of <a class="el" href="confuse_8h.html#a1339bde1f672aa0279a51bf2324545d" title="Returns the value of a section option.">cfg_getsec()</a>, used for sections with the CFGF_MULTI flag set.
! 1251: <p>
! 1252: <dl compact><dt><b>Parameters:</b></dt><dd>
! 1253: <table border="0" cellspacing="2" cellpadding="0">
! 1254: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 1255: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option. </td></tr>
! 1256: <tr><td valign="top"></td><td valign="top"><em>index</em> </td><td>Index of the section to get. Zero based. </td></tr>
! 1257: </table>
! 1258: </dl>
! 1259: <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#a1339bde1f672aa0279a51bf2324545d" title="Returns the value of a section option.">cfg_getsec</a> </dd></dl>
! 1260: <dl compact><dt><b>Examples: </b></dt><dd>
! 1261: <a class="el" href="ftpconf_8c-example.html#a27">ftpconf.c</a>, and <a class="el" href="reread_8c-example.html#a15">reread.c</a>.</dl>
! 1262: </div>
! 1263: </div><p>
! 1264: <a class="anchor" name="abb00a590331a4d9d4e772201dff34d1"></a><!-- doxytag: member="confuse.h::cfg_getnstr" ref="abb00a590331a4d9d4e772201dff34d1" args="(cfg_t *cfg, const char *name, unsigned int index)" -->
! 1265: <div class="memitem">
! 1266: <div class="memproto">
! 1267: <table class="memname">
! 1268: <tr>
! 1269: <td class="memname">DLLIMPORT char* __export cfg_getnstr </td>
! 1270: <td>(</td>
! 1271: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 1272: <td class="paramname"> <em>cfg</em>, </td>
! 1273: </tr>
! 1274: <tr>
! 1275: <td class="paramkey"></td>
! 1276: <td></td>
! 1277: <td class="paramtype">const char * </td>
! 1278: <td class="paramname"> <em>name</em>, </td>
! 1279: </tr>
! 1280: <tr>
! 1281: <td class="paramkey"></td>
! 1282: <td></td>
! 1283: <td class="paramtype">unsigned int </td>
! 1284: <td class="paramname"> <em>index</em></td><td> </td>
! 1285: </tr>
! 1286: <tr>
! 1287: <td></td>
! 1288: <td>)</td>
! 1289: <td></td><td></td><td></td>
! 1290: </tr>
! 1291: </table>
! 1292: </div>
! 1293: <div class="memdoc">
! 1294:
! 1295: <p>
! 1296: Indexed version of <a class="el" href="confuse_8h.html#4a9c34acc55cca63649c088d98053905" title="Returns the value of a string option.">cfg_getstr()</a>, used for lists.
! 1297: <p>
! 1298: <dl compact><dt><b>Parameters:</b></dt><dd>
! 1299: <table border="0" cellspacing="2" cellpadding="0">
! 1300: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 1301: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option. </td></tr>
! 1302: <tr><td valign="top"></td><td valign="top"><em>index</em> </td><td>Index of the value to get. Zero based. </td></tr>
! 1303: </table>
! 1304: </dl>
! 1305: <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#4a9c34acc55cca63649c088d98053905" title="Returns the value of a string option.">cfg_getstr</a> </dd></dl>
! 1306: <dl compact><dt><b>Examples: </b></dt><dd>
! 1307: <a class="el" href="ftpconf_8c-example.html#a30">ftpconf.c</a>.</dl>
! 1308: </div>
! 1309: </div><p>
! 1310: <a class="anchor" name="33f48558624569678272f46925ead40f"></a><!-- doxytag: member="confuse.h::cfg_getopt" ref="33f48558624569678272f46925ead40f" args="(cfg_t *cfg, const char *name)" -->
! 1311: <div class="memitem">
! 1312: <div class="memproto">
! 1313: <table class="memname">
! 1314: <tr>
! 1315: <td class="memname">DLLIMPORT <a class="el" href="structcfg__opt__t.html">cfg_opt_t</a>* __export cfg_getopt </td>
! 1316: <td>(</td>
! 1317: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 1318: <td class="paramname"> <em>cfg</em>, </td>
! 1319: </tr>
! 1320: <tr>
! 1321: <td class="paramkey"></td>
! 1322: <td></td>
! 1323: <td class="paramtype">const char * </td>
! 1324: <td class="paramname"> <em>name</em></td><td> </td>
! 1325: </tr>
! 1326: <tr>
! 1327: <td></td>
! 1328: <td>)</td>
! 1329: <td></td><td></td><td></td>
! 1330: </tr>
! 1331: </table>
! 1332: </div>
! 1333: <div class="memdoc">
! 1334:
! 1335: <p>
! 1336: Return an option given it's name.
! 1337: <p>
! 1338: <dl compact><dt><b>Parameters:</b></dt><dd>
! 1339: <table border="0" cellspacing="2" cellpadding="0">
! 1340: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 1341: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option.</td></tr>
! 1342: </table>
! 1343: </dl>
! 1344: <dl class="return" compact><dt><b>Returns:</b></dt><dd>Returns a pointer to the option. If the option isn't declared, libConfuse will print an error message and return 0. </dd></dl>
! 1345:
! 1346: <p>References <a class="el" href="confuse_8h-source.html#l00084">CFGF_NOCASE</a>, <a class="el" href="confuse_8h-source.html#l00215">cfg_t::flags</a>, <a class="el" href="confuse_8h-source.html#l00258">cfg_opt_t::name</a>, <a class="el" href="confuse_8h-source.html#l00216">cfg_t::name</a>, and <a class="el" href="confuse_8h-source.html#l00219">cfg_t::opts</a>.</p>
! 1347:
! 1348: </div>
! 1349: </div><p>
! 1350: <a class="anchor" name="d4f0fdb31b6c0113b3c78891e8ee5429"></a><!-- doxytag: member="confuse.h::cfg_getptr" ref="d4f0fdb31b6c0113b3c78891e8ee5429" args="(cfg_t *cfg, const char *name)" -->
! 1351: <div class="memitem">
! 1352: <div class="memproto">
! 1353: <table class="memname">
! 1354: <tr>
! 1355: <td class="memname">DLLIMPORT void* __export cfg_getptr </td>
! 1356: <td>(</td>
! 1357: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 1358: <td class="paramname"> <em>cfg</em>, </td>
! 1359: </tr>
! 1360: <tr>
! 1361: <td class="paramkey"></td>
! 1362: <td></td>
! 1363: <td class="paramtype">const char * </td>
! 1364: <td class="paramname"> <em>name</em></td><td> </td>
! 1365: </tr>
! 1366: <tr>
! 1367: <td></td>
! 1368: <td>)</td>
! 1369: <td></td><td></td><td></td>
! 1370: </tr>
! 1371: </table>
! 1372: </div>
! 1373: <div class="memdoc">
! 1374:
! 1375: <p>
! 1376: Returns the value of a user-defined option (void pointer).
! 1377: <p>
! 1378: <dl compact><dt><b>Parameters:</b></dt><dd>
! 1379: <table border="0" cellspacing="2" cellpadding="0">
! 1380: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 1381: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option. </td></tr>
! 1382: </table>
! 1383: </dl>
! 1384: <dl class="return" compact><dt><b>Returns:</b></dt><dd>The requested value is returned. If the option was not set in the configuration file, the default value given in the corresponding <a class="el" href="structcfg__opt__t.html" title="Data structure holding information about an option.">cfg_opt_t</a> structure is returned. It is an error to try to get an option that isn't declared. </dd></dl>
! 1385:
! 1386: </div>
! 1387: </div><p>
! 1388: <a class="anchor" name="a1339bde1f672aa0279a51bf2324545d"></a><!-- doxytag: member="confuse.h::cfg_getsec" ref="a1339bde1f672aa0279a51bf2324545d" args="(cfg_t *cfg, const char *name)" -->
! 1389: <div class="memitem">
! 1390: <div class="memproto">
! 1391: <table class="memname">
! 1392: <tr>
! 1393: <td class="memname">DLLIMPORT <a class="el" href="structcfg__t.html">cfg_t</a>* __export cfg_getsec </td>
! 1394: <td>(</td>
! 1395: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 1396: <td class="paramname"> <em>cfg</em>, </td>
! 1397: </tr>
! 1398: <tr>
! 1399: <td class="paramkey"></td>
! 1400: <td></td>
! 1401: <td class="paramtype">const char * </td>
! 1402: <td class="paramname"> <em>name</em></td><td> </td>
! 1403: </tr>
! 1404: <tr>
! 1405: <td></td>
! 1406: <td>)</td>
! 1407: <td></td><td></td><td></td>
! 1408: </tr>
! 1409: </table>
! 1410: </div>
! 1411: <div class="memdoc">
! 1412:
! 1413: <p>
! 1414: Returns the value of a section option.
! 1415: <p>
! 1416: The returned value is another <a class="el" href="structcfg__t.html" title="Data structure holding information about a "section".">cfg_t</a> structure that can be used in following calls to cfg_getint, cfg_getstr or other get-functions. <dl compact><dt><b>Parameters:</b></dt><dd>
! 1417: <table border="0" cellspacing="2" cellpadding="0">
! 1418: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 1419: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option. </td></tr>
! 1420: </table>
! 1421: </dl>
! 1422: <dl class="return" compact><dt><b>Returns:</b></dt><dd>The requested section is returned. If no section is found with that name, 0 is returned. There can only be default values for section without the CFGF_MULTI flag set. It is an error to try to get a section that isn't declared. </dd></dl>
! 1423:
! 1424: </div>
! 1425: </div><p>
! 1426: <a class="anchor" name="4a9c34acc55cca63649c088d98053905"></a><!-- doxytag: member="confuse.h::cfg_getstr" ref="4a9c34acc55cca63649c088d98053905" args="(cfg_t *cfg, const char *name)" -->
! 1427: <div class="memitem">
! 1428: <div class="memproto">
! 1429: <table class="memname">
! 1430: <tr>
! 1431: <td class="memname">DLLIMPORT char* __export cfg_getstr </td>
! 1432: <td>(</td>
! 1433: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 1434: <td class="paramname"> <em>cfg</em>, </td>
! 1435: </tr>
! 1436: <tr>
! 1437: <td class="paramkey"></td>
! 1438: <td></td>
! 1439: <td class="paramtype">const char * </td>
! 1440: <td class="paramname"> <em>name</em></td><td> </td>
! 1441: </tr>
! 1442: <tr>
! 1443: <td></td>
! 1444: <td>)</td>
! 1445: <td></td><td></td><td></td>
! 1446: </tr>
! 1447: </table>
! 1448: </div>
! 1449: <div class="memdoc">
! 1450:
! 1451: <p>
! 1452: Returns the value of a string option.
! 1453: <p>
! 1454: <dl compact><dt><b>Parameters:</b></dt><dd>
! 1455: <table border="0" cellspacing="2" cellpadding="0">
! 1456: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 1457: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option. </td></tr>
! 1458: </table>
! 1459: </dl>
! 1460: <dl class="return" compact><dt><b>Returns:</b></dt><dd>The requested value is returned. If the option was not set in the configuration file, the default value given in the corresponding <a class="el" href="structcfg__opt__t.html" title="Data structure holding information about an option.">cfg_opt_t</a> structure is returned. It is an error to try to get an option that isn't declared. </dd></dl>
! 1461: <dl compact><dt><b>Examples: </b></dt><dd>
! 1462: <a class="el" href="ftpconf_8c-example.html#a28">ftpconf.c</a>, and <a class="el" href="reread_8c-example.html#a13">reread.c</a>.</dl>
! 1463: </div>
! 1464: </div><p>
! 1465: <a class="anchor" name="c1fda0e6937653d891ae276ae69d0f76"></a><!-- doxytag: member="confuse.h::cfg_gettsec" ref="c1fda0e6937653d891ae276ae69d0f76" args="(cfg_t *cfg, const char *name, const char *title)" -->
! 1466: <div class="memitem">
! 1467: <div class="memproto">
! 1468: <table class="memname">
! 1469: <tr>
! 1470: <td class="memname">DLLIMPORT <a class="el" href="structcfg__t.html">cfg_t</a>* __export cfg_gettsec </td>
! 1471: <td>(</td>
! 1472: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 1473: <td class="paramname"> <em>cfg</em>, </td>
! 1474: </tr>
! 1475: <tr>
! 1476: <td class="paramkey"></td>
! 1477: <td></td>
! 1478: <td class="paramtype">const char * </td>
! 1479: <td class="paramname"> <em>name</em>, </td>
! 1480: </tr>
! 1481: <tr>
! 1482: <td class="paramkey"></td>
! 1483: <td></td>
! 1484: <td class="paramtype">const char * </td>
! 1485: <td class="paramname"> <em>title</em></td><td> </td>
! 1486: </tr>
! 1487: <tr>
! 1488: <td></td>
! 1489: <td>)</td>
! 1490: <td></td><td></td><td></td>
! 1491: </tr>
! 1492: </table>
! 1493: </div>
! 1494: <div class="memdoc">
! 1495:
! 1496: <p>
! 1497: Return a section given the title, used for section with the CFGF_TITLE flag set.
! 1498: <p>
! 1499: <dl compact><dt><b>Parameters:</b></dt><dd>
! 1500: <table border="0" cellspacing="2" cellpadding="0">
! 1501: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 1502: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option. </td></tr>
! 1503: <tr><td valign="top"></td><td valign="top"><em>title</em> </td><td>The title of this section. The CFGF_TITLE flag must have been set for this option. </td></tr>
! 1504: </table>
! 1505: </dl>
! 1506: <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#a1339bde1f672aa0279a51bf2324545d" title="Returns the value of a section option.">cfg_getsec</a> </dd></dl>
! 1507:
! 1508: </div>
! 1509: </div><p>
! 1510: <a class="anchor" name="73e8e62914759632e5d5165fa877f4b3"></a><!-- doxytag: member="confuse.h::cfg_include" ref="73e8e62914759632e5d5165fa877f4b3" args="(cfg_t *cfg, cfg_opt_t *opt, int argc, const char **argv)" -->
! 1511: <div class="memitem">
! 1512: <div class="memproto">
! 1513: <table class="memname">
! 1514: <tr>
! 1515: <td class="memname">DLLIMPORT int __export cfg_include </td>
! 1516: <td>(</td>
! 1517: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 1518: <td class="paramname"> <em>cfg</em>, </td>
! 1519: </tr>
! 1520: <tr>
! 1521: <td class="paramkey"></td>
! 1522: <td></td>
! 1523: <td class="paramtype"><a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> * </td>
! 1524: <td class="paramname"> <em>opt</em>, </td>
! 1525: </tr>
! 1526: <tr>
! 1527: <td class="paramkey"></td>
! 1528: <td></td>
! 1529: <td class="paramtype">int </td>
! 1530: <td class="paramname"> <em>argc</em>, </td>
! 1531: </tr>
! 1532: <tr>
! 1533: <td class="paramkey"></td>
! 1534: <td></td>
! 1535: <td class="paramtype">const char ** </td>
! 1536: <td class="paramname"> <em>argv</em></td><td> </td>
! 1537: </tr>
! 1538: <tr>
! 1539: <td></td>
! 1540: <td>)</td>
! 1541: <td></td><td></td><td></td>
! 1542: </tr>
! 1543: </table>
! 1544: </div>
! 1545: <div class="memdoc">
! 1546:
! 1547: <p>
! 1548: Predefined include-function.
! 1549: <p>
! 1550: This function can be used in the options passed to <a class="el" href="confuse_8h.html#ec07794916564c8ab437e030ac618aa8" title="Create and initialize a cfg_t structure.">cfg_init()</a> to specify a function for including other configuration files in the parsing. For example: CFG_FUNC("include", &cfg_include) <dl compact><dt><b>Examples: </b></dt><dd>
! 1551: <a class="el" href="ftpconf_8c-example.html#a21">ftpconf.c</a>.</dl>
! 1552: </div>
! 1553: </div><p>
! 1554: <a class="anchor" name="ec07794916564c8ab437e030ac618aa8"></a><!-- doxytag: member="confuse.h::cfg_init" ref="ec07794916564c8ab437e030ac618aa8" args="(cfg_opt_t *opts, cfg_flag_t flags)" -->
! 1555: <div class="memitem">
! 1556: <div class="memproto">
! 1557: <table class="memname">
! 1558: <tr>
! 1559: <td class="memname">DLLIMPORT <a class="el" href="structcfg__t.html">cfg_t</a>* __export cfg_init </td>
! 1560: <td>(</td>
! 1561: <td class="paramtype"><a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> * </td>
! 1562: <td class="paramname"> <em>opts</em>, </td>
! 1563: </tr>
! 1564: <tr>
! 1565: <td class="paramkey"></td>
! 1566: <td></td>
! 1567: <td class="paramtype">cfg_flag_t </td>
! 1568: <td class="paramname"> <em>flags</em></td><td> </td>
! 1569: </tr>
! 1570: <tr>
! 1571: <td></td>
! 1572: <td>)</td>
! 1573: <td></td><td></td><td></td>
! 1574: </tr>
! 1575: </table>
! 1576: </div>
! 1577: <div class="memdoc">
! 1578:
! 1579: <p>
! 1580: Create and initialize a <a class="el" href="structcfg__t.html" title="Data structure holding information about a "section".">cfg_t</a> structure.
! 1581: <p>
! 1582: This should be the first function called when setting up the parsing of a configuration file. The options passed in the first parameter is initialized using the CFG_* initializers. The last option in the option array must be <a class="el" href="confuse_8h.html#6b29dd8a4c6cd3d392d4ab6b2e535597" title="Terminate list of options.">CFG_END()</a>, unless you like segmentation faults.<p>
! 1583: The options must no longer be defined in the same scope as where the cfg_xxx functions are used (since version 2.3).<p>
! 1584: <dl compact><dt><b>Parameters:</b></dt><dd>
! 1585: <table border="0" cellspacing="2" cellpadding="0">
! 1586: <tr><td valign="top"></td><td valign="top"><em>opts</em> </td><td>An arrary of options </td></tr>
! 1587: <tr><td valign="top"></td><td valign="top"><em>flags</em> </td><td>One or more flags (bitwise or'ed together). Currently only CFGF_NOCASE is available. Use 0 if no flags are needed.</td></tr>
! 1588: </table>
! 1589: </dl>
! 1590: <dl class="return" compact><dt><b>Returns:</b></dt><dd>A configuration context structure. This pointer is passed to almost all other functions as the first parameter. </dd></dl>
! 1591: <dl compact><dt><b>Examples: </b></dt><dd>
! 1592: <a class="el" href="ftpconf_8c-example.html#a22">ftpconf.c</a>, <a class="el" href="reread_8c-example.html#a10">reread.c</a>, and <a class="el" href="simple_8c-example.html#a7">simple.c</a>.</dl>
! 1593: <p>References <a class="el" href="confuse_8h-source.html#l00224">cfg_t::errfunc</a>, <a class="el" href="confuse_8h-source.html#l00222">cfg_t::filename</a>, <a class="el" href="confuse_8h-source.html#l00215">cfg_t::flags</a>, <a class="el" href="confuse_8h-source.html#l00223">cfg_t::line</a>, <a class="el" href="confuse_8h-source.html#l00216">cfg_t::name</a>, and <a class="el" href="confuse_8h-source.html#l00219">cfg_t::opts</a>.</p>
! 1594:
! 1595: </div>
! 1596: </div><p>
! 1597: <a class="anchor" name="af379c267736432e004cccf3b2786bfa"></a><!-- doxytag: member="confuse.h::cfg_name" ref="af379c267736432e004cccf3b2786bfa" args="(cfg_t *cfg)" -->
! 1598: <div class="memitem">
! 1599: <div class="memproto">
! 1600: <table class="memname">
! 1601: <tr>
! 1602: <td class="memname">DLLIMPORT const char* __export cfg_name </td>
! 1603: <td>(</td>
! 1604: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 1605: <td class="paramname"> <em>cfg</em> </td>
! 1606: <td> ) </td>
! 1607: <td></td>
! 1608: </tr>
! 1609: </table>
! 1610: </div>
! 1611: <div class="memdoc">
! 1612:
! 1613: <p>
! 1614: Return the name of a section.
! 1615: <p>
! 1616: <dl compact><dt><b>Parameters:</b></dt><dd>
! 1617: <table border="0" cellspacing="2" cellpadding="0">
! 1618: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 1619: </table>
! 1620: </dl>
! 1621: <dl class="return" compact><dt><b>Returns:</b></dt><dd>Returns the title, or 0 if there is no title. This string should not be modified. </dd></dl>
! 1622: <dl compact><dt><b>Examples: </b></dt><dd>
! 1623: <a class="el" href="ftpconf_8c-example.html#a5">ftpconf.c</a>.</dl>
! 1624: <p>References <a class="el" href="confuse_8h-source.html#l00216">cfg_t::name</a>.</p>
! 1625:
! 1626: </div>
! 1627: </div><p>
! 1628: <a class="anchor" name="f49441953ac0c45960728b347c25dba3"></a><!-- doxytag: member="confuse.h::cfg_opt_getnbool" ref="f49441953ac0c45960728b347c25dba3" args="(cfg_opt_t *opt, unsigned int index)" -->
! 1629: <div class="memitem">
! 1630: <div class="memproto">
! 1631: <table class="memname">
! 1632: <tr>
! 1633: <td class="memname">DLLIMPORT <a class="el" href="confuse_8h.html#4bce4b6aed9b07489d6a5c70321907e4">cfg_bool_t</a> __export cfg_opt_getnbool </td>
! 1634: <td>(</td>
! 1635: <td class="paramtype"><a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> * </td>
! 1636: <td class="paramname"> <em>opt</em>, </td>
! 1637: </tr>
! 1638: <tr>
! 1639: <td class="paramkey"></td>
! 1640: <td></td>
! 1641: <td class="paramtype">unsigned int </td>
! 1642: <td class="paramname"> <em>index</em></td><td> </td>
! 1643: </tr>
! 1644: <tr>
! 1645: <td></td>
! 1646: <td>)</td>
! 1647: <td></td><td></td><td></td>
! 1648: </tr>
! 1649: </table>
! 1650: </div>
! 1651: <div class="memdoc">
! 1652:
! 1653: <p>
! 1654: Returns the value of a boolean option, given a <a class="el" href="structcfg__opt__t.html" title="Data structure holding information about an option.">cfg_opt_t</a> pointer.
! 1655: <p>
! 1656: <dl compact><dt><b>Parameters:</b></dt><dd>
! 1657: <table border="0" cellspacing="2" cellpadding="0">
! 1658: <tr><td valign="top"></td><td valign="top"><em>opt</em> </td><td>The option structure (eg, as returned from <a class="el" href="confuse_8h.html#33f48558624569678272f46925ead40f" title="Return an option given it's name.">cfg_getopt()</a>) </td></tr>
! 1659: <tr><td valign="top"></td><td valign="top"><em>index</em> </td><td>Index of the value to get. Zero based. </td></tr>
! 1660: </table>
! 1661: </dl>
! 1662: <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#8984944ec9de3a67e3007bfba32f2127" title="Indexed version of cfg_getbool(), used for lists.">cfg_getnbool</a> </dd></dl>
! 1663:
! 1664: <p>References <a class="el" href="confuse_8h-source.html#l00234">cfg_value_t::boolean</a>, <a class="el" href="confuse_8h-source.html#l00073">CFGT_BOOL</a>, <a class="el" href="confuse_8h-source.html#l00266">cfg_opt_t::simple_value</a>, <a class="el" href="confuse_8h-source.html#l00259">cfg_opt_t::type</a>, and <a class="el" href="confuse_8h-source.html#l00261">cfg_opt_t::values</a>.</p>
! 1665:
! 1666: </div>
! 1667: </div><p>
! 1668: <a class="anchor" name="a93c59e332c95937db84f93c1a9b25bd"></a><!-- doxytag: member="confuse.h::cfg_opt_getnfloat" ref="a93c59e332c95937db84f93c1a9b25bd" args="(cfg_opt_t *opt, unsigned int index)" -->
! 1669: <div class="memitem">
! 1670: <div class="memproto">
! 1671: <table class="memname">
! 1672: <tr>
! 1673: <td class="memname">DLLIMPORT double __export cfg_opt_getnfloat </td>
! 1674: <td>(</td>
! 1675: <td class="paramtype"><a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> * </td>
! 1676: <td class="paramname"> <em>opt</em>, </td>
! 1677: </tr>
! 1678: <tr>
! 1679: <td class="paramkey"></td>
! 1680: <td></td>
! 1681: <td class="paramtype">unsigned int </td>
! 1682: <td class="paramname"> <em>index</em></td><td> </td>
! 1683: </tr>
! 1684: <tr>
! 1685: <td></td>
! 1686: <td>)</td>
! 1687: <td></td><td></td><td></td>
! 1688: </tr>
! 1689: </table>
! 1690: </div>
! 1691: <div class="memdoc">
! 1692:
! 1693: <p>
! 1694: Returns the value of a floating point option, given a <a class="el" href="structcfg__opt__t.html" title="Data structure holding information about an option.">cfg_opt_t</a> pointer.
! 1695: <p>
! 1696: <dl compact><dt><b>Parameters:</b></dt><dd>
! 1697: <table border="0" cellspacing="2" cellpadding="0">
! 1698: <tr><td valign="top"></td><td valign="top"><em>opt</em> </td><td>The option structure (eg, as returned from <a class="el" href="confuse_8h.html#33f48558624569678272f46925ead40f" title="Return an option given it's name.">cfg_getopt()</a>) </td></tr>
! 1699: <tr><td valign="top"></td><td valign="top"><em>index</em> </td><td>Index of the value to get. Zero based. </td></tr>
! 1700: </table>
! 1701: </dl>
! 1702: <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#af63837150498ce6ecd530a9769f9e43" title="Indexed version of cfg_getfloat(), used for lists.">cfg_getnfloat</a> </dd></dl>
! 1703:
! 1704: <p>References <a class="el" href="confuse_8h-source.html#l00071">CFGT_FLOAT</a>, <a class="el" href="confuse_8h-source.html#l00233">cfg_value_t::fpnumber</a>, <a class="el" href="confuse_8h-source.html#l00266">cfg_opt_t::simple_value</a>, <a class="el" href="confuse_8h-source.html#l00259">cfg_opt_t::type</a>, and <a class="el" href="confuse_8h-source.html#l00261">cfg_opt_t::values</a>.</p>
! 1705:
! 1706: </div>
! 1707: </div><p>
! 1708: <a class="anchor" name="baa00b2bb179bfc1062c67da8b2beae3"></a><!-- doxytag: member="confuse.h::cfg_opt_getnint" ref="baa00b2bb179bfc1062c67da8b2beae3" args="(cfg_opt_t *opt, unsigned int index)" -->
! 1709: <div class="memitem">
! 1710: <div class="memproto">
! 1711: <table class="memname">
! 1712: <tr>
! 1713: <td class="memname">DLLIMPORT signed long __export cfg_opt_getnint </td>
! 1714: <td>(</td>
! 1715: <td class="paramtype"><a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> * </td>
! 1716: <td class="paramname"> <em>opt</em>, </td>
! 1717: </tr>
! 1718: <tr>
! 1719: <td class="paramkey"></td>
! 1720: <td></td>
! 1721: <td class="paramtype">unsigned int </td>
! 1722: <td class="paramname"> <em>index</em></td><td> </td>
! 1723: </tr>
! 1724: <tr>
! 1725: <td></td>
! 1726: <td>)</td>
! 1727: <td></td><td></td><td></td>
! 1728: </tr>
! 1729: </table>
! 1730: </div>
! 1731: <div class="memdoc">
! 1732:
! 1733: <p>
! 1734: Returns the value of an integer option, given a <a class="el" href="structcfg__opt__t.html" title="Data structure holding information about an option.">cfg_opt_t</a> pointer.
! 1735: <p>
! 1736: <dl compact><dt><b>Parameters:</b></dt><dd>
! 1737: <table border="0" cellspacing="2" cellpadding="0">
! 1738: <tr><td valign="top"></td><td valign="top"><em>opt</em> </td><td>The option structure (eg, as returned from <a class="el" href="confuse_8h.html#33f48558624569678272f46925ead40f" title="Return an option given it's name.">cfg_getopt()</a>) </td></tr>
! 1739: <tr><td valign="top"></td><td valign="top"><em>index</em> </td><td>Index of the value to get. Zero based. </td></tr>
! 1740: </table>
! 1741: </dl>
! 1742: <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#ddba63989fbf548cb0365ce875f138d4" title="Indexed version of cfg_getint(), used for lists.">cfg_getnint</a> </dd></dl>
! 1743: <dl compact><dt><b>Examples: </b></dt><dd>
! 1744: <a class="el" href="ftpconf_8c-example.html#a4">ftpconf.c</a>.</dl>
! 1745: <p>References <a class="el" href="confuse_8h-source.html#l00070">CFGT_INT</a>, <a class="el" href="confuse_8h-source.html#l00232">cfg_value_t::number</a>, <a class="el" href="confuse_8h-source.html#l00266">cfg_opt_t::simple_value</a>, <a class="el" href="confuse_8h-source.html#l00259">cfg_opt_t::type</a>, and <a class="el" href="confuse_8h-source.html#l00261">cfg_opt_t::values</a>.</p>
! 1746:
! 1747: </div>
! 1748: </div><p>
! 1749: <a class="anchor" name="4312c6bc126283ad8b6dc849c1138a71"></a><!-- doxytag: member="confuse.h::cfg_opt_getnsec" ref="4312c6bc126283ad8b6dc849c1138a71" args="(cfg_opt_t *opt, unsigned int index)" -->
! 1750: <div class="memitem">
! 1751: <div class="memproto">
! 1752: <table class="memname">
! 1753: <tr>
! 1754: <td class="memname">DLLIMPORT <a class="el" href="structcfg__t.html">cfg_t</a>* __export cfg_opt_getnsec </td>
! 1755: <td>(</td>
! 1756: <td class="paramtype"><a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> * </td>
! 1757: <td class="paramname"> <em>opt</em>, </td>
! 1758: </tr>
! 1759: <tr>
! 1760: <td class="paramkey"></td>
! 1761: <td></td>
! 1762: <td class="paramtype">unsigned int </td>
! 1763: <td class="paramname"> <em>index</em></td><td> </td>
! 1764: </tr>
! 1765: <tr>
! 1766: <td></td>
! 1767: <td>)</td>
! 1768: <td></td><td></td><td></td>
! 1769: </tr>
! 1770: </table>
! 1771: </div>
! 1772: <div class="memdoc">
! 1773:
! 1774: <p>
! 1775: Returns the value of a section option, given a <a class="el" href="structcfg__opt__t.html" title="Data structure holding information about an option.">cfg_opt_t</a> pointer.
! 1776: <p>
! 1777: <dl compact><dt><b>Parameters:</b></dt><dd>
! 1778: <table border="0" cellspacing="2" cellpadding="0">
! 1779: <tr><td valign="top"></td><td valign="top"><em>opt</em> </td><td>The option structure (eg, as returned from <a class="el" href="confuse_8h.html#33f48558624569678272f46925ead40f" title="Return an option given it's name.">cfg_getopt()</a>) </td></tr>
! 1780: <tr><td valign="top"></td><td valign="top"><em>index</em> </td><td>Index of the value to get. Zero based. </td></tr>
! 1781: </table>
! 1782: </dl>
! 1783: <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#d5e8eea765588892053b73eed4017edd" title="Indexed version of cfg_getsec(), used for sections with the CFGF_MULTI flag set.">cfg_getnsec</a> </dd></dl>
! 1784: <dl compact><dt><b>Examples: </b></dt><dd>
! 1785: <a class="el" href="ftpconf_8c-example.html#a6">ftpconf.c</a>.</dl>
! 1786: <p>References <a class="el" href="confuse_8h-source.html#l00074">CFGT_SEC</a>, <a class="el" href="confuse_8h-source.html#l00236">cfg_value_t::section</a>, <a class="el" href="confuse_8h-source.html#l00259">cfg_opt_t::type</a>, and <a class="el" href="confuse_8h-source.html#l00261">cfg_opt_t::values</a>.</p>
! 1787:
! 1788: </div>
! 1789: </div><p>
! 1790: <a class="anchor" name="99289f214566005664f05cac4dc50318"></a><!-- doxytag: member="confuse.h::cfg_opt_getnstr" ref="99289f214566005664f05cac4dc50318" args="(cfg_opt_t *opt, unsigned int index)" -->
! 1791: <div class="memitem">
! 1792: <div class="memproto">
! 1793: <table class="memname">
! 1794: <tr>
! 1795: <td class="memname">DLLIMPORT char* __export cfg_opt_getnstr </td>
! 1796: <td>(</td>
! 1797: <td class="paramtype"><a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> * </td>
! 1798: <td class="paramname"> <em>opt</em>, </td>
! 1799: </tr>
! 1800: <tr>
! 1801: <td class="paramkey"></td>
! 1802: <td></td>
! 1803: <td class="paramtype">unsigned int </td>
! 1804: <td class="paramname"> <em>index</em></td><td> </td>
! 1805: </tr>
! 1806: <tr>
! 1807: <td></td>
! 1808: <td>)</td>
! 1809: <td></td><td></td><td></td>
! 1810: </tr>
! 1811: </table>
! 1812: </div>
! 1813: <div class="memdoc">
! 1814:
! 1815: <p>
! 1816: Returns the value of a string option, given a <a class="el" href="structcfg__opt__t.html" title="Data structure holding information about an option.">cfg_opt_t</a> pointer.
! 1817: <p>
! 1818: <dl compact><dt><b>Parameters:</b></dt><dd>
! 1819: <table border="0" cellspacing="2" cellpadding="0">
! 1820: <tr><td valign="top"></td><td valign="top"><em>opt</em> </td><td>The option structure (eg, as returned from <a class="el" href="confuse_8h.html#33f48558624569678272f46925ead40f" title="Return an option given it's name.">cfg_getopt()</a>) </td></tr>
! 1821: <tr><td valign="top"></td><td valign="top"><em>index</em> </td><td>Index of the value to get. Zero based. </td></tr>
! 1822: </table>
! 1823: </dl>
! 1824: <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#abb00a590331a4d9d4e772201dff34d1" title="Indexed version of cfg_getstr(), used for lists.">cfg_getnstr</a> </dd></dl>
! 1825:
! 1826: <p>References <a class="el" href="confuse_8h-source.html#l00072">CFGT_STR</a>, <a class="el" href="confuse_8h-source.html#l00266">cfg_opt_t::simple_value</a>, <a class="el" href="confuse_8h-source.html#l00235">cfg_value_t::string</a>, <a class="el" href="confuse_8h-source.html#l00259">cfg_opt_t::type</a>, and <a class="el" href="confuse_8h-source.html#l00261">cfg_opt_t::values</a>.</p>
! 1827:
! 1828: </div>
! 1829: </div><p>
! 1830: <a class="anchor" name="dec6a5049ac8306b0892f274e6d406ad"></a><!-- doxytag: member="confuse.h::cfg_opt_gettsec" ref="dec6a5049ac8306b0892f274e6d406ad" args="(cfg_opt_t *opt, const char *title)" -->
! 1831: <div class="memitem">
! 1832: <div class="memproto">
! 1833: <table class="memname">
! 1834: <tr>
! 1835: <td class="memname">DLLIMPORT <a class="el" href="structcfg__t.html">cfg_t</a>* __export cfg_opt_gettsec </td>
! 1836: <td>(</td>
! 1837: <td class="paramtype"><a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> * </td>
! 1838: <td class="paramname"> <em>opt</em>, </td>
! 1839: </tr>
! 1840: <tr>
! 1841: <td class="paramkey"></td>
! 1842: <td></td>
! 1843: <td class="paramtype">const char * </td>
! 1844: <td class="paramname"> <em>title</em></td><td> </td>
! 1845: </tr>
! 1846: <tr>
! 1847: <td></td>
! 1848: <td>)</td>
! 1849: <td></td><td></td><td></td>
! 1850: </tr>
! 1851: </table>
! 1852: </div>
! 1853: <div class="memdoc">
! 1854:
! 1855: <p>
! 1856: Returns the value of a section option, given a <a class="el" href="structcfg__opt__t.html" title="Data structure holding information about an option.">cfg_opt_t</a> pointer and the title.
! 1857: <p>
! 1858: <dl compact><dt><b>Parameters:</b></dt><dd>
! 1859: <table border="0" cellspacing="2" cellpadding="0">
! 1860: <tr><td valign="top"></td><td valign="top"><em>opt</em> </td><td>The option structure (eg, as returned from <a class="el" href="confuse_8h.html#33f48558624569678272f46925ead40f" title="Return an option given it's name.">cfg_getopt()</a>) </td></tr>
! 1861: <tr><td valign="top"></td><td valign="top"><em>title</em> </td><td>The title of this section. The CFGF_TITLE flag must have been set for this option. </td></tr>
! 1862: </table>
! 1863: </dl>
! 1864: <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#c1fda0e6937653d891ae276ae69d0f76" title="Return a section given the title, used for section with the CFGF_TITLE flag set.">cfg_gettsec</a> </dd></dl>
! 1865:
! 1866: <p>References <a class="el" href="confuse_8h-source.html#l00084">CFGF_NOCASE</a>, <a class="el" href="confuse_8h-source.html#l00085">CFGF_TITLE</a>, <a class="el" href="confuse_8h-source.html#l00262">cfg_opt_t::flags</a>, and <a class="el" href="confuse_8h-source.html#l00220">cfg_t::title</a>.</p>
! 1867:
! 1868: </div>
! 1869: </div><p>
! 1870: <a class="anchor" name="6d3645d6140afbd45b0f2b1475e56ffe"></a><!-- doxytag: member="confuse.h::cfg_opt_name" ref="6d3645d6140afbd45b0f2b1475e56ffe" args="(cfg_opt_t *opt)" -->
! 1871: <div class="memitem">
! 1872: <div class="memproto">
! 1873: <table class="memname">
! 1874: <tr>
! 1875: <td class="memname">DLLIMPORT const char* __export cfg_opt_name </td>
! 1876: <td>(</td>
! 1877: <td class="paramtype"><a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> * </td>
! 1878: <td class="paramname"> <em>opt</em> </td>
! 1879: <td> ) </td>
! 1880: <td></td>
! 1881: </tr>
! 1882: </table>
! 1883: </div>
! 1884: <div class="memdoc">
! 1885:
! 1886: <p>
! 1887: Return the name of an option.
! 1888: <p>
! 1889: <dl compact><dt><b>Parameters:</b></dt><dd>
! 1890: <table border="0" cellspacing="2" cellpadding="0">
! 1891: <tr><td valign="top"></td><td valign="top"><em>opt</em> </td><td>The option structure (eg, as returned from <a class="el" href="confuse_8h.html#33f48558624569678272f46925ead40f" title="Return an option given it's name.">cfg_getopt()</a>) </td></tr>
! 1892: </table>
! 1893: </dl>
! 1894: <dl class="return" compact><dt><b>Returns:</b></dt><dd>Returns the title, or 0 if there is no title. This string should not be modified. </dd></dl>
! 1895: <dl compact><dt><b>Examples: </b></dt><dd>
! 1896: <a class="el" href="ftpconf_8c-example.html#a3">ftpconf.c</a>.</dl>
! 1897: <p>References <a class="el" href="confuse_8h-source.html#l00258">cfg_opt_t::name</a>.</p>
! 1898:
! 1899: </div>
! 1900: </div><p>
! 1901: <a class="anchor" name="6b04cb223e843bee362021dcce9e5cc8"></a><!-- doxytag: member="confuse.h::cfg_opt_nprint_var" ref="6b04cb223e843bee362021dcce9e5cc8" args="(cfg_opt_t *opt, unsigned int index, FILE *fp)" -->
! 1902: <div class="memitem">
! 1903: <div class="memproto">
! 1904: <table class="memname">
! 1905: <tr>
! 1906: <td class="memname">DLLIMPORT void __export cfg_opt_nprint_var </td>
! 1907: <td>(</td>
! 1908: <td class="paramtype"><a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> * </td>
! 1909: <td class="paramname"> <em>opt</em>, </td>
! 1910: </tr>
! 1911: <tr>
! 1912: <td class="paramkey"></td>
! 1913: <td></td>
! 1914: <td class="paramtype">unsigned int </td>
! 1915: <td class="paramname"> <em>index</em>, </td>
! 1916: </tr>
! 1917: <tr>
! 1918: <td class="paramkey"></td>
! 1919: <td></td>
! 1920: <td class="paramtype">FILE * </td>
! 1921: <td class="paramname"> <em>fp</em></td><td> </td>
! 1922: </tr>
! 1923: <tr>
! 1924: <td></td>
! 1925: <td>)</td>
! 1926: <td></td><td></td><td></td>
! 1927: </tr>
! 1928: </table>
! 1929: </div>
! 1930: <div class="memdoc">
! 1931:
! 1932: <p>
! 1933: Default value print function.
! 1934: <p>
! 1935: Print only the value of a given option. Does not handle sections or functions. Use cfg_opt_print to print the whole assignment ("option = value"), or cfg_print to print the whole config file.<p>
! 1936: <dl compact><dt><b>Parameters:</b></dt><dd>
! 1937: <table border="0" cellspacing="2" cellpadding="0">
! 1938: <tr><td valign="top"></td><td valign="top"><em>opt</em> </td><td>The option structure (eg, as returned from <a class="el" href="confuse_8h.html#33f48558624569678272f46925ead40f" title="Return an option given it's name.">cfg_getopt()</a>) </td></tr>
! 1939: <tr><td valign="top"></td><td valign="top"><em>index</em> </td><td>The index in the option value array that should be printed </td></tr>
! 1940: <tr><td valign="top"></td><td valign="top"><em>fp</em> </td><td>File stream to print to.</td></tr>
! 1941: </table>
! 1942: </dl>
! 1943: <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#f4254e5ea4b856c4072df8526de929b2" title="Print the options and values to a file.">cfg_print</a>, <a class="el" href="confuse_8h.html#62f2b7c1ec02443315f43250c7a84728" title="Print an option and its value to a file.">cfg_opt_print</a> </dd></dl>
! 1944:
! 1945: <p>References <a class="el" href="confuse_8h-source.html#l00073">CFGT_BOOL</a>, <a class="el" href="confuse_8h-source.html#l00071">CFGT_FLOAT</a>, <a class="el" href="confuse_8h-source.html#l00075">CFGT_FUNC</a>, <a class="el" href="confuse_8h-source.html#l00070">CFGT_INT</a>, <a class="el" href="confuse_8h-source.html#l00076">CFGT_PTR</a>, <a class="el" href="confuse_8h-source.html#l00074">CFGT_SEC</a>, <a class="el" href="confuse_8h-source.html#l00072">CFGT_STR</a>, and <a class="el" href="confuse_8h-source.html#l00259">cfg_opt_t::type</a>.</p>
! 1946:
! 1947: </div>
! 1948: </div><p>
! 1949: <a class="anchor" name="62f2b7c1ec02443315f43250c7a84728"></a><!-- doxytag: member="confuse.h::cfg_opt_print" ref="62f2b7c1ec02443315f43250c7a84728" args="(cfg_opt_t *opt, FILE *fp)" -->
! 1950: <div class="memitem">
! 1951: <div class="memproto">
! 1952: <table class="memname">
! 1953: <tr>
! 1954: <td class="memname">DLLIMPORT void __export cfg_opt_print </td>
! 1955: <td>(</td>
! 1956: <td class="paramtype"><a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> * </td>
! 1957: <td class="paramname"> <em>opt</em>, </td>
! 1958: </tr>
! 1959: <tr>
! 1960: <td class="paramkey"></td>
! 1961: <td></td>
! 1962: <td class="paramtype">FILE * </td>
! 1963: <td class="paramname"> <em>fp</em></td><td> </td>
! 1964: </tr>
! 1965: <tr>
! 1966: <td></td>
! 1967: <td>)</td>
! 1968: <td></td><td></td><td></td>
! 1969: </tr>
! 1970: </table>
! 1971: </div>
! 1972: <div class="memdoc">
! 1973:
! 1974: <p>
! 1975: Print an option and its value to a file.
! 1976: <p>
! 1977: If a print callback function is specified for the option, it is used instead of cfg_opt_nprint_var.<p>
! 1978: <dl compact><dt><b>Parameters:</b></dt><dd>
! 1979: <table border="0" cellspacing="2" cellpadding="0">
! 1980: <tr><td valign="top"></td><td valign="top"><em>opt</em> </td><td>The option structure (eg, as returned from <a class="el" href="confuse_8h.html#33f48558624569678272f46925ead40f" title="Return an option given it's name.">cfg_getopt()</a>) </td></tr>
! 1981: <tr><td valign="top"></td><td valign="top"><em>fp</em> </td><td>File stream to print to.</td></tr>
! 1982: </table>
! 1983: </dl>
! 1984: <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#488182780ff16a94457f0d1242416154" title="Function prototype used by the cfg_print_ functions.">cfg_print_func_t</a> </dd></dl>
! 1985:
! 1986: </div>
! 1987: </div><p>
! 1988: <a class="anchor" name="7d764da177c6c53e8540b5416e09541f"></a><!-- doxytag: member="confuse.h::cfg_opt_print_indent" ref="7d764da177c6c53e8540b5416e09541f" args="(cfg_opt_t *opt, FILE *fp, int indent)" -->
! 1989: <div class="memitem">
! 1990: <div class="memproto">
! 1991: <table class="memname">
! 1992: <tr>
! 1993: <td class="memname">DLLIMPORT void __export cfg_opt_print_indent </td>
! 1994: <td>(</td>
! 1995: <td class="paramtype"><a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> * </td>
! 1996: <td class="paramname"> <em>opt</em>, </td>
! 1997: </tr>
! 1998: <tr>
! 1999: <td class="paramkey"></td>
! 2000: <td></td>
! 2001: <td class="paramtype">FILE * </td>
! 2002: <td class="paramname"> <em>fp</em>, </td>
! 2003: </tr>
! 2004: <tr>
! 2005: <td class="paramkey"></td>
! 2006: <td></td>
! 2007: <td class="paramtype">int </td>
! 2008: <td class="paramname"> <em>indent</em></td><td> </td>
! 2009: </tr>
! 2010: <tr>
! 2011: <td></td>
! 2012: <td>)</td>
! 2013: <td></td><td></td><td></td>
! 2014: </tr>
! 2015: </table>
! 2016: </div>
! 2017: <div class="memdoc">
! 2018:
! 2019: <p>
! 2020: Print an option and its value to a file.
! 2021: <p>
! 2022: Same as cfg_opt_print, but with the indentation level specified. <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#62f2b7c1ec02443315f43250c7a84728" title="Print an option and its value to a file.">cfg_opt_print</a> </dd></dl>
! 2023:
! 2024: <p>References <a class="el" href="confuse_8h-source.html#l00083">CFGF_LIST</a>, <a class="el" href="confuse_8h-source.html#l00085">CFGF_TITLE</a>, <a class="el" href="confuse_8h-source.html#l00075">CFGT_FUNC</a>, <a class="el" href="confuse_8h-source.html#l00074">CFGT_SEC</a>, <a class="el" href="confuse_8h-source.html#l00072">CFGT_STR</a>, <a class="el" href="confuse_8h-source.html#l00262">cfg_opt_t::flags</a>, <a class="el" href="confuse_8h-source.html#l00258">cfg_opt_t::name</a>, <a class="el" href="confuse_8h-source.html#l00260">cfg_opt_t::nvalues</a>, <a class="el" href="confuse_8h-source.html#l00271">cfg_opt_t::pf</a>, <a class="el" href="confuse_8h-source.html#l00266">cfg_opt_t::simple_value</a>, <a class="el" href="confuse_8h-source.html#l00235">cfg_value_t::string</a>, <a class="el" href="confuse_8h-source.html#l00259">cfg_opt_t::type</a>, and <a class="el" href="confuse_8h-source.html#l00261">cfg_opt_t::values</a>.</p>
! 2025:
! 2026: </div>
! 2027: </div><p>
! 2028: <a class="anchor" name="292ba236b86cbe1bec047a467c8d605d"></a><!-- doxytag: member="confuse.h::cfg_opt_set_print_func" ref="292ba236b86cbe1bec047a467c8d605d" args="(cfg_opt_t *opt, cfg_print_func_t pf)" -->
! 2029: <div class="memitem">
! 2030: <div class="memproto">
! 2031: <table class="memname">
! 2032: <tr>
! 2033: <td class="memname">DLLIMPORT <a class="el" href="confuse_8h.html#488182780ff16a94457f0d1242416154">cfg_print_func_t</a> __export cfg_opt_set_print_func </td>
! 2034: <td>(</td>
! 2035: <td class="paramtype"><a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> * </td>
! 2036: <td class="paramname"> <em>opt</em>, </td>
! 2037: </tr>
! 2038: <tr>
! 2039: <td class="paramkey"></td>
! 2040: <td></td>
! 2041: <td class="paramtype"><a class="el" href="confuse_8h.html#488182780ff16a94457f0d1242416154">cfg_print_func_t</a> </td>
! 2042: <td class="paramname"> <em>pf</em></td><td> </td>
! 2043: </tr>
! 2044: <tr>
! 2045: <td></td>
! 2046: <td>)</td>
! 2047: <td></td><td></td><td></td>
! 2048: </tr>
! 2049: </table>
! 2050: </div>
! 2051: <div class="memdoc">
! 2052:
! 2053: <p>
! 2054: Set a print callback function for an option.
! 2055: <p>
! 2056: <dl compact><dt><b>Parameters:</b></dt><dd>
! 2057: <table border="0" cellspacing="2" cellpadding="0">
! 2058: <tr><td valign="top"></td><td valign="top"><em>opt</em> </td><td>The option structure (eg, as returned from <a class="el" href="confuse_8h.html#33f48558624569678272f46925ead40f" title="Return an option given it's name.">cfg_getopt()</a>) </td></tr>
! 2059: <tr><td valign="top"></td><td valign="top"><em>pf</em> </td><td>The print function callback.</td></tr>
! 2060: </table>
! 2061: </dl>
! 2062: <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#488182780ff16a94457f0d1242416154" title="Function prototype used by the cfg_print_ functions.">cfg_print_func_t</a> </dd></dl>
! 2063:
! 2064: <p>References <a class="el" href="confuse_8h-source.html#l00271">cfg_opt_t::pf</a>.</p>
! 2065:
! 2066: </div>
! 2067: </div><p>
! 2068: <a class="anchor" name="e49271c4d9188f20ba2f507d14f8ed04"></a><!-- doxytag: member="confuse.h::cfg_opt_setnbool" ref="e49271c4d9188f20ba2f507d14f8ed04" args="(cfg_opt_t *opt, cfg_bool_t value, unsigned int index)" -->
! 2069: <div class="memitem">
! 2070: <div class="memproto">
! 2071: <table class="memname">
! 2072: <tr>
! 2073: <td class="memname">DLLIMPORT void __export cfg_opt_setnbool </td>
! 2074: <td>(</td>
! 2075: <td class="paramtype"><a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> * </td>
! 2076: <td class="paramname"> <em>opt</em>, </td>
! 2077: </tr>
! 2078: <tr>
! 2079: <td class="paramkey"></td>
! 2080: <td></td>
! 2081: <td class="paramtype"><a class="el" href="confuse_8h.html#4bce4b6aed9b07489d6a5c70321907e4">cfg_bool_t</a> </td>
! 2082: <td class="paramname"> <em>value</em>, </td>
! 2083: </tr>
! 2084: <tr>
! 2085: <td class="paramkey"></td>
! 2086: <td></td>
! 2087: <td class="paramtype">unsigned int </td>
! 2088: <td class="paramname"> <em>index</em></td><td> </td>
! 2089: </tr>
! 2090: <tr>
! 2091: <td></td>
! 2092: <td>)</td>
! 2093: <td></td><td></td><td></td>
! 2094: </tr>
! 2095: </table>
! 2096: </div>
! 2097: <div class="memdoc">
! 2098:
! 2099: <p>
! 2100: Set a value of a boolean option.
! 2101: <p>
! 2102: <dl compact><dt><b>Parameters:</b></dt><dd>
! 2103: <table border="0" cellspacing="2" cellpadding="0">
! 2104: <tr><td valign="top"></td><td valign="top"><em>opt</em> </td><td>The option structure (eg, as returned from <a class="el" href="confuse_8h.html#33f48558624569678272f46925ead40f" title="Return an option given it's name.">cfg_getopt()</a>) </td></tr>
! 2105: <tr><td valign="top"></td><td valign="top"><em>value</em> </td><td>The value to set. </td></tr>
! 2106: <tr><td valign="top"></td><td valign="top"><em>index</em> </td><td>The index in the option value array that should be modified. It is an error to set values with indices larger than 0 for options without the CFGF_LIST flag set. </td></tr>
! 2107: </table>
! 2108: </dl>
! 2109:
! 2110: <p>References <a class="el" href="confuse_8h-source.html#l00234">cfg_value_t::boolean</a>, <a class="el" href="confuse_8h-source.html#l00073">CFGT_BOOL</a>, and <a class="el" href="confuse_8h-source.html#l00259">cfg_opt_t::type</a>.</p>
! 2111:
! 2112: </div>
! 2113: </div><p>
! 2114: <a class="anchor" name="8b3d540078b83cbc91697eac952f2ad2"></a><!-- doxytag: member="confuse.h::cfg_opt_setnfloat" ref="8b3d540078b83cbc91697eac952f2ad2" args="(cfg_opt_t *opt, double value, unsigned int index)" -->
! 2115: <div class="memitem">
! 2116: <div class="memproto">
! 2117: <table class="memname">
! 2118: <tr>
! 2119: <td class="memname">DLLIMPORT void __export cfg_opt_setnfloat </td>
! 2120: <td>(</td>
! 2121: <td class="paramtype"><a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> * </td>
! 2122: <td class="paramname"> <em>opt</em>, </td>
! 2123: </tr>
! 2124: <tr>
! 2125: <td class="paramkey"></td>
! 2126: <td></td>
! 2127: <td class="paramtype">double </td>
! 2128: <td class="paramname"> <em>value</em>, </td>
! 2129: </tr>
! 2130: <tr>
! 2131: <td class="paramkey"></td>
! 2132: <td></td>
! 2133: <td class="paramtype">unsigned int </td>
! 2134: <td class="paramname"> <em>index</em></td><td> </td>
! 2135: </tr>
! 2136: <tr>
! 2137: <td></td>
! 2138: <td>)</td>
! 2139: <td></td><td></td><td></td>
! 2140: </tr>
! 2141: </table>
! 2142: </div>
! 2143: <div class="memdoc">
! 2144:
! 2145: <p>
! 2146: Set a value of a floating point option.
! 2147: <p>
! 2148: <dl compact><dt><b>Parameters:</b></dt><dd>
! 2149: <table border="0" cellspacing="2" cellpadding="0">
! 2150: <tr><td valign="top"></td><td valign="top"><em>opt</em> </td><td>The option structure (eg, as returned from <a class="el" href="confuse_8h.html#33f48558624569678272f46925ead40f" title="Return an option given it's name.">cfg_getopt()</a>) </td></tr>
! 2151: <tr><td valign="top"></td><td valign="top"><em>value</em> </td><td>The value to set. </td></tr>
! 2152: <tr><td valign="top"></td><td valign="top"><em>index</em> </td><td>The index in the option value array that should be modified. It is an error to set values with indices larger than 0 for options without the CFGF_LIST flag set. </td></tr>
! 2153: </table>
! 2154: </dl>
! 2155:
! 2156: <p>References <a class="el" href="confuse_8h-source.html#l00071">CFGT_FLOAT</a>, <a class="el" href="confuse_8h-source.html#l00233">cfg_value_t::fpnumber</a>, and <a class="el" href="confuse_8h-source.html#l00259">cfg_opt_t::type</a>.</p>
! 2157:
! 2158: </div>
! 2159: </div><p>
! 2160: <a class="anchor" name="47cf0b1d0a9aebbff9846937be98f5bb"></a><!-- doxytag: member="confuse.h::cfg_opt_setnint" ref="47cf0b1d0a9aebbff9846937be98f5bb" args="(cfg_opt_t *opt, long int value, unsigned int index)" -->
! 2161: <div class="memitem">
! 2162: <div class="memproto">
! 2163: <table class="memname">
! 2164: <tr>
! 2165: <td class="memname">DLLIMPORT void __export cfg_opt_setnint </td>
! 2166: <td>(</td>
! 2167: <td class="paramtype"><a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> * </td>
! 2168: <td class="paramname"> <em>opt</em>, </td>
! 2169: </tr>
! 2170: <tr>
! 2171: <td class="paramkey"></td>
! 2172: <td></td>
! 2173: <td class="paramtype">long int </td>
! 2174: <td class="paramname"> <em>value</em>, </td>
! 2175: </tr>
! 2176: <tr>
! 2177: <td class="paramkey"></td>
! 2178: <td></td>
! 2179: <td class="paramtype">unsigned int </td>
! 2180: <td class="paramname"> <em>index</em></td><td> </td>
! 2181: </tr>
! 2182: <tr>
! 2183: <td></td>
! 2184: <td>)</td>
! 2185: <td></td><td></td><td></td>
! 2186: </tr>
! 2187: </table>
! 2188: </div>
! 2189: <div class="memdoc">
! 2190:
! 2191: <p>
! 2192: Set a value of an integer option.
! 2193: <p>
! 2194: <dl compact><dt><b>Parameters:</b></dt><dd>
! 2195: <table border="0" cellspacing="2" cellpadding="0">
! 2196: <tr><td valign="top"></td><td valign="top"><em>opt</em> </td><td>The option structure (eg, as returned from <a class="el" href="confuse_8h.html#33f48558624569678272f46925ead40f" title="Return an option given it's name.">cfg_getopt()</a>) </td></tr>
! 2197: <tr><td valign="top"></td><td valign="top"><em>value</em> </td><td>The value to set. </td></tr>
! 2198: <tr><td valign="top"></td><td valign="top"><em>index</em> </td><td>The index in the option value array that should be modified. It is an error to set values with indices larger than 0 for options without the CFGF_LIST flag set. </td></tr>
! 2199: </table>
! 2200: </dl>
! 2201:
! 2202: <p>References <a class="el" href="confuse_8h-source.html#l00070">CFGT_INT</a>, <a class="el" href="confuse_8h-source.html#l00232">cfg_value_t::number</a>, and <a class="el" href="confuse_8h-source.html#l00259">cfg_opt_t::type</a>.</p>
! 2203:
! 2204: </div>
! 2205: </div><p>
! 2206: <a class="anchor" name="6ea17369ab2edbe94c236894a5b9df23"></a><!-- doxytag: member="confuse.h::cfg_opt_setnstr" ref="6ea17369ab2edbe94c236894a5b9df23" args="(cfg_opt_t *opt, const char *value, unsigned int index)" -->
! 2207: <div class="memitem">
! 2208: <div class="memproto">
! 2209: <table class="memname">
! 2210: <tr>
! 2211: <td class="memname">DLLIMPORT void __export cfg_opt_setnstr </td>
! 2212: <td>(</td>
! 2213: <td class="paramtype"><a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> * </td>
! 2214: <td class="paramname"> <em>opt</em>, </td>
! 2215: </tr>
! 2216: <tr>
! 2217: <td class="paramkey"></td>
! 2218: <td></td>
! 2219: <td class="paramtype">const char * </td>
! 2220: <td class="paramname"> <em>value</em>, </td>
! 2221: </tr>
! 2222: <tr>
! 2223: <td class="paramkey"></td>
! 2224: <td></td>
! 2225: <td class="paramtype">unsigned int </td>
! 2226: <td class="paramname"> <em>index</em></td><td> </td>
! 2227: </tr>
! 2228: <tr>
! 2229: <td></td>
! 2230: <td>)</td>
! 2231: <td></td><td></td><td></td>
! 2232: </tr>
! 2233: </table>
! 2234: </div>
! 2235: <div class="memdoc">
! 2236:
! 2237: <p>
! 2238: Set a value of a string option.
! 2239: <p>
! 2240: <dl compact><dt><b>Parameters:</b></dt><dd>
! 2241: <table border="0" cellspacing="2" cellpadding="0">
! 2242: <tr><td valign="top"></td><td valign="top"><em>opt</em> </td><td>The option structure (eg, as returned from <a class="el" href="confuse_8h.html#33f48558624569678272f46925ead40f" title="Return an option given it's name.">cfg_getopt()</a>) </td></tr>
! 2243: <tr><td valign="top"></td><td valign="top"><em>value</em> </td><td>The value to set. Memory for the string is allocated and the value is copied. Any previous string value is freed. </td></tr>
! 2244: <tr><td valign="top"></td><td valign="top"><em>index</em> </td><td>The index in the option value array that should be modified. It is an error to set values with indices larger than 0 for options without the CFGF_LIST flag set. </td></tr>
! 2245: </table>
! 2246: </dl>
! 2247:
! 2248: <p>References <a class="el" href="confuse_8h-source.html#l00072">CFGT_STR</a>, <a class="el" href="confuse_8h-source.html#l00235">cfg_value_t::string</a>, and <a class="el" href="confuse_8h-source.html#l00259">cfg_opt_t::type</a>.</p>
! 2249:
! 2250: </div>
! 2251: </div><p>
! 2252: <a class="anchor" name="1648e78297e9bc970b1f3fa90a715da6"></a><!-- doxytag: member="confuse.h::cfg_opt_size" ref="1648e78297e9bc970b1f3fa90a715da6" args="(cfg_opt_t *opt)" -->
! 2253: <div class="memitem">
! 2254: <div class="memproto">
! 2255: <table class="memname">
! 2256: <tr>
! 2257: <td class="memname">DLLIMPORT unsigned int __export cfg_opt_size </td>
! 2258: <td>(</td>
! 2259: <td class="paramtype"><a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> * </td>
! 2260: <td class="paramname"> <em>opt</em> </td>
! 2261: <td> ) </td>
! 2262: <td></td>
! 2263: </tr>
! 2264: </table>
! 2265: </div>
! 2266: <div class="memdoc">
! 2267:
! 2268: <p>
! 2269: Return the number of values this option has.
! 2270: <p>
! 2271: If no default value is given for the option and no value was found in the config file, 0 will be returned (ie, the option value is not set at all). <dl compact><dt><b>Parameters:</b></dt><dd>
! 2272: <table border="0" cellspacing="2" cellpadding="0">
! 2273: <tr><td valign="top"></td><td valign="top"><em>opt</em> </td><td>The option structure (eg, as returned from <a class="el" href="confuse_8h.html#33f48558624569678272f46925ead40f" title="Return an option given it's name.">cfg_getopt()</a>) </td></tr>
! 2274: </table>
! 2275: </dl>
! 2276: <dl compact><dt><b>Examples: </b></dt><dd>
! 2277: <a class="el" href="ftpconf_8c-example.html#a7">ftpconf.c</a>.</dl>
! 2278: <p>References <a class="el" href="confuse_8h-source.html#l00260">cfg_opt_t::nvalues</a>.</p>
! 2279:
! 2280: </div>
! 2281: </div><p>
! 2282: <a class="anchor" name="0fca327466956c5580199e24397d49fe"></a><!-- doxytag: member="confuse.h::cfg_parse" ref="0fca327466956c5580199e24397d49fe" args="(cfg_t *cfg, const char *filename)" -->
! 2283: <div class="memitem">
! 2284: <div class="memproto">
! 2285: <table class="memname">
! 2286: <tr>
! 2287: <td class="memname">DLLIMPORT int __export cfg_parse </td>
! 2288: <td>(</td>
! 2289: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 2290: <td class="paramname"> <em>cfg</em>, </td>
! 2291: </tr>
! 2292: <tr>
! 2293: <td class="paramkey"></td>
! 2294: <td></td>
! 2295: <td class="paramtype">const char * </td>
! 2296: <td class="paramname"> <em>filename</em></td><td> </td>
! 2297: </tr>
! 2298: <tr>
! 2299: <td></td>
! 2300: <td>)</td>
! 2301: <td></td><td></td><td></td>
! 2302: </tr>
! 2303: </table>
! 2304: </div>
! 2305: <div class="memdoc">
! 2306:
! 2307: <p>
! 2308: Parse a configuration file.
! 2309: <p>
! 2310: Tilde expansion is performed on the filename before it is opened. After a configuration file has been initialized (with <a class="el" href="confuse_8h.html#ec07794916564c8ab437e030ac618aa8" title="Create and initialize a cfg_t structure.">cfg_init()</a>) and parsed (with <a class="el" href="confuse_8h.html#0fca327466956c5580199e24397d49fe" title="Parse a configuration file.">cfg_parse()</a>), the values can be read with the cfg_getXXX functions.<p>
! 2311: <dl compact><dt><b>Parameters:</b></dt><dd>
! 2312: <table border="0" cellspacing="2" cellpadding="0">
! 2313: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context as returned from <a class="el" href="confuse_8h.html#ec07794916564c8ab437e030ac618aa8" title="Create and initialize a cfg_t structure.">cfg_init()</a>. </td></tr>
! 2314: <tr><td valign="top"></td><td valign="top"><em>filename</em> </td><td>The name of the file to parse.</td></tr>
! 2315: </table>
! 2316: </dl>
! 2317: <dl class="return" compact><dt><b>Returns:</b></dt><dd>On success, CFG_SUCCESS is returned. If the file couldn't be opened for reading, CFG_FILE_ERROR is returned. On all other errors, CFG_PARSE_ERROR is returned and <a class="el" href="confuse_8h.html#5b448a145f12b67e90bd4e6bd387f129" title="Show a parser error.">cfg_error()</a> was called with a descriptive error message. </dd></dl>
! 2318: <dl compact><dt><b>Examples: </b></dt><dd>
! 2319: <a class="el" href="ftpconf_8c-example.html#a24">ftpconf.c</a>, <a class="el" href="reread_8c-example.html#a12">reread.c</a>, and <a class="el" href="simple_8c-example.html#a8">simple.c</a>.</dl>
! 2320: <p>References <a class="el" href="confuse_8h-source.html#l00222">cfg_t::filename</a>.</p>
! 2321:
! 2322: </div>
! 2323: </div><p>
! 2324: <a class="anchor" name="527f63939bf3f0b5d635fd86cd562086"></a><!-- doxytag: member="confuse.h::cfg_parse_boolean" ref="527f63939bf3f0b5d635fd86cd562086" args="(const char *s)" -->
! 2325: <div class="memitem">
! 2326: <div class="memproto">
! 2327: <table class="memname">
! 2328: <tr>
! 2329: <td class="memname">DLLIMPORT int __export cfg_parse_boolean </td>
! 2330: <td>(</td>
! 2331: <td class="paramtype">const char * </td>
! 2332: <td class="paramname"> <em>s</em> </td>
! 2333: <td> ) </td>
! 2334: <td></td>
! 2335: </tr>
! 2336: </table>
! 2337: </div>
! 2338: <div class="memdoc">
! 2339:
! 2340: <p>
! 2341: Parse a boolean option string.
! 2342: <p>
! 2343: Accepted "true" values are "true", "on" and "yes", and accepted "false" values are "false", "off" and "no".<p>
! 2344: <dl class="return" compact><dt><b>Returns:</b></dt><dd>Returns 1 or 0 (true/false) if the string was parsed correctly, or -1 if an error occurred. </dd></dl>
! 2345:
! 2346: </div>
! 2347: </div><p>
! 2348: <a class="anchor" name="6da020721a065f359cf343f014e7834c"></a><!-- doxytag: member="confuse.h::cfg_parse_buf" ref="6da020721a065f359cf343f014e7834c" args="(cfg_t *cfg, const char *buf)" -->
! 2349: <div class="memitem">
! 2350: <div class="memproto">
! 2351: <table class="memname">
! 2352: <tr>
! 2353: <td class="memname">DLLIMPORT int __export cfg_parse_buf </td>
! 2354: <td>(</td>
! 2355: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 2356: <td class="paramname"> <em>cfg</em>, </td>
! 2357: </tr>
! 2358: <tr>
! 2359: <td class="paramkey"></td>
! 2360: <td></td>
! 2361: <td class="paramtype">const char * </td>
! 2362: <td class="paramname"> <em>buf</em></td><td> </td>
! 2363: </tr>
! 2364: <tr>
! 2365: <td></td>
! 2366: <td>)</td>
! 2367: <td></td><td></td><td></td>
! 2368: </tr>
! 2369: </table>
! 2370: </div>
! 2371: <div class="memdoc">
! 2372:
! 2373: <p>
! 2374: Same as <a class="el" href="confuse_8h.html#0fca327466956c5580199e24397d49fe" title="Parse a configuration file.">cfg_parse()</a> above, but takes a character buffer as argument.
! 2375: <p>
! 2376: <dl compact><dt><b>Parameters:</b></dt><dd>
! 2377: <table border="0" cellspacing="2" cellpadding="0">
! 2378: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context as returned from <a class="el" href="confuse_8h.html#ec07794916564c8ab437e030ac618aa8" title="Create and initialize a cfg_t structure.">cfg_init()</a>. </td></tr>
! 2379: <tr><td valign="top"></td><td valign="top"><em>buf</em> </td><td>A zero-terminated string with configuration directives.</td></tr>
! 2380: </table>
! 2381: </dl>
! 2382: <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#0fca327466956c5580199e24397d49fe" title="Parse a configuration file.">cfg_parse()</a> </dd></dl>
! 2383: <dl compact><dt><b>Examples: </b></dt><dd>
! 2384: <a class="el" href="reread_8c-example.html#a11">reread.c</a>.</dl>
! 2385: <p>References <a class="el" href="confuse_8h-source.html#l00095">CFG_SUCCESS</a>, <a class="el" href="confuse_8h-source.html#l00222">cfg_t::filename</a>, and <a class="el" href="confuse_8h-source.html#l00223">cfg_t::line</a>.</p>
! 2386:
! 2387: </div>
! 2388: </div><p>
! 2389: <a class="anchor" name="7ff54be21c704c3150ad439d7e17dcca"></a><!-- doxytag: member="confuse.h::cfg_parse_fp" ref="7ff54be21c704c3150ad439d7e17dcca" args="(cfg_t *cfg, FILE *fp)" -->
! 2390: <div class="memitem">
! 2391: <div class="memproto">
! 2392: <table class="memname">
! 2393: <tr>
! 2394: <td class="memname">DLLIMPORT int __export cfg_parse_fp </td>
! 2395: <td>(</td>
! 2396: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 2397: <td class="paramname"> <em>cfg</em>, </td>
! 2398: </tr>
! 2399: <tr>
! 2400: <td class="paramkey"></td>
! 2401: <td></td>
! 2402: <td class="paramtype">FILE * </td>
! 2403: <td class="paramname"> <em>fp</em></td><td> </td>
! 2404: </tr>
! 2405: <tr>
! 2406: <td></td>
! 2407: <td>)</td>
! 2408: <td></td><td></td><td></td>
! 2409: </tr>
! 2410: </table>
! 2411: </div>
! 2412: <div class="memdoc">
! 2413:
! 2414: <p>
! 2415: Same as <a class="el" href="confuse_8h.html#0fca327466956c5580199e24397d49fe" title="Parse a configuration file.">cfg_parse()</a> above, but takes an already opened file as argument.
! 2416: <p>
! 2417: Reading begins at the current position. After parsing, the position is not reset. The caller is responsible for closing the file.<p>
! 2418: <dl compact><dt><b>Parameters:</b></dt><dd>
! 2419: <table border="0" cellspacing="2" cellpadding="0">
! 2420: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context as returned from <a class="el" href="confuse_8h.html#ec07794916564c8ab437e030ac618aa8" title="Create and initialize a cfg_t structure.">cfg_init()</a>. </td></tr>
! 2421: <tr><td valign="top"></td><td valign="top"><em>fp</em> </td><td>An open file stream.</td></tr>
! 2422: </table>
! 2423: </dl>
! 2424: <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#0fca327466956c5580199e24397d49fe" title="Parse a configuration file.">cfg_parse()</a> </dd></dl>
! 2425:
! 2426: <p>References <a class="el" href="confuse_8h-source.html#l00095">CFG_SUCCESS</a>, <a class="el" href="confuse_8h-source.html#l00222">cfg_t::filename</a>, and <a class="el" href="confuse_8h-source.html#l00223">cfg_t::line</a>.</p>
! 2427:
! 2428: </div>
! 2429: </div><p>
! 2430: <a class="anchor" name="f4254e5ea4b856c4072df8526de929b2"></a><!-- doxytag: member="confuse.h::cfg_print" ref="f4254e5ea4b856c4072df8526de929b2" args="(cfg_t *cfg, FILE *fp)" -->
! 2431: <div class="memitem">
! 2432: <div class="memproto">
! 2433: <table class="memname">
! 2434: <tr>
! 2435: <td class="memname">DLLIMPORT void __export cfg_print </td>
! 2436: <td>(</td>
! 2437: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 2438: <td class="paramname"> <em>cfg</em>, </td>
! 2439: </tr>
! 2440: <tr>
! 2441: <td class="paramkey"></td>
! 2442: <td></td>
! 2443: <td class="paramtype">FILE * </td>
! 2444: <td class="paramname"> <em>fp</em></td><td> </td>
! 2445: </tr>
! 2446: <tr>
! 2447: <td></td>
! 2448: <td>)</td>
! 2449: <td></td><td></td><td></td>
! 2450: </tr>
! 2451: </table>
! 2452: </div>
! 2453: <div class="memdoc">
! 2454:
! 2455: <p>
! 2456: Print the options and values to a file.
! 2457: <p>
! 2458: Note that options in any included file are expanded and printed directly to the file. Option values given with environment variables in the parsed input are also printed expanded. This means that if you parse a configuration file you can't expect that the output from this function is identical to the initial file.<p>
! 2459: <dl compact><dt><b>Parameters:</b></dt><dd>
! 2460: <table border="0" cellspacing="2" cellpadding="0">
! 2461: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 2462: <tr><td valign="top"></td><td valign="top"><em>fp</em> </td><td>File stream to print to, use stdout to print to the screen.</td></tr>
! 2463: </table>
! 2464: </dl>
! 2465: <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#488182780ff16a94457f0d1242416154" title="Function prototype used by the cfg_print_ functions.">cfg_print_func_t</a>, <a class="el" href="confuse_8h.html#03bdd2ac7828e5161e68da93cb07238d" title="Set a print callback function for an option given its name.">cfg_set_print_func</a> </dd></dl>
! 2466: <dl compact><dt><b>Examples: </b></dt><dd>
! 2467: <a class="el" href="simple_8c-example.html#a10">simple.c</a>.</dl>
! 2468: </div>
! 2469: </div><p>
! 2470: <a class="anchor" name="ac68b8ff7e5000071afdd4a8660aeb91"></a><!-- doxytag: member="confuse.h::cfg_print_indent" ref="ac68b8ff7e5000071afdd4a8660aeb91" args="(cfg_t *cfg, FILE *fp, int indent)" -->
! 2471: <div class="memitem">
! 2472: <div class="memproto">
! 2473: <table class="memname">
! 2474: <tr>
! 2475: <td class="memname">DLLIMPORT void __export cfg_print_indent </td>
! 2476: <td>(</td>
! 2477: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 2478: <td class="paramname"> <em>cfg</em>, </td>
! 2479: </tr>
! 2480: <tr>
! 2481: <td class="paramkey"></td>
! 2482: <td></td>
! 2483: <td class="paramtype">FILE * </td>
! 2484: <td class="paramname"> <em>fp</em>, </td>
! 2485: </tr>
! 2486: <tr>
! 2487: <td class="paramkey"></td>
! 2488: <td></td>
! 2489: <td class="paramtype">int </td>
! 2490: <td class="paramname"> <em>indent</em></td><td> </td>
! 2491: </tr>
! 2492: <tr>
! 2493: <td></td>
! 2494: <td>)</td>
! 2495: <td></td><td></td><td></td>
! 2496: </tr>
! 2497: </table>
! 2498: </div>
! 2499: <div class="memdoc">
! 2500:
! 2501: <p>
! 2502: Print the options and values to a file.
! 2503: <p>
! 2504: Same as cfg_print, but with the indentation level specified. <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#f4254e5ea4b856c4072df8526de929b2" title="Print the options and values to a file.">cfg_print</a> </dd></dl>
! 2505:
! 2506: <p>References <a class="el" href="confuse_8h-source.html#l00258">cfg_opt_t::name</a>, and <a class="el" href="confuse_8h-source.html#l00219">cfg_t::opts</a>.</p>
! 2507:
! 2508: </div>
! 2509: </div><p>
! 2510: <a class="anchor" name="e5cd3df98ec4c9895fbe73fd1c32f7a1"></a><!-- doxytag: member="confuse.h::cfg_set_error_function" ref="e5cd3df98ec4c9895fbe73fd1c32f7a1" args="(cfg_t *cfg, cfg_errfunc_t errfunc)" -->
! 2511: <div class="memitem">
! 2512: <div class="memproto">
! 2513: <table class="memname">
! 2514: <tr>
! 2515: <td class="memname">DLLIMPORT <a class="el" href="confuse_8h.html#e4244b478d80a5ec06a1f5a46dd04fbe">cfg_errfunc_t</a> __export cfg_set_error_function </td>
! 2516: <td>(</td>
! 2517: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 2518: <td class="paramname"> <em>cfg</em>, </td>
! 2519: </tr>
! 2520: <tr>
! 2521: <td class="paramkey"></td>
! 2522: <td></td>
! 2523: <td class="paramtype"><a class="el" href="confuse_8h.html#e4244b478d80a5ec06a1f5a46dd04fbe">cfg_errfunc_t</a> </td>
! 2524: <td class="paramname"> <em>errfunc</em></td><td> </td>
! 2525: </tr>
! 2526: <tr>
! 2527: <td></td>
! 2528: <td>)</td>
! 2529: <td></td><td></td><td></td>
! 2530: </tr>
! 2531: </table>
! 2532: </div>
! 2533: <div class="memdoc">
! 2534:
! 2535: <p>
! 2536: Install a user-defined error reporting function.
! 2537: <p>
! 2538: <dl class="return" compact><dt><b>Returns:</b></dt><dd>The old error reporting function is returned. </dd></dl>
! 2539:
! 2540: <p>References <a class="el" href="confuse_8h-source.html#l00224">cfg_t::errfunc</a>.</p>
! 2541:
! 2542: </div>
! 2543: </div><p>
! 2544: <a class="anchor" name="03bdd2ac7828e5161e68da93cb07238d"></a><!-- doxytag: member="confuse.h::cfg_set_print_func" ref="03bdd2ac7828e5161e68da93cb07238d" args="(cfg_t *cfg, const char *name, cfg_print_func_t pf)" -->
! 2545: <div class="memitem">
! 2546: <div class="memproto">
! 2547: <table class="memname">
! 2548: <tr>
! 2549: <td class="memname">DLLIMPORT <a class="el" href="confuse_8h.html#488182780ff16a94457f0d1242416154">cfg_print_func_t</a> __export cfg_set_print_func </td>
! 2550: <td>(</td>
! 2551: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 2552: <td class="paramname"> <em>cfg</em>, </td>
! 2553: </tr>
! 2554: <tr>
! 2555: <td class="paramkey"></td>
! 2556: <td></td>
! 2557: <td class="paramtype">const char * </td>
! 2558: <td class="paramname"> <em>name</em>, </td>
! 2559: </tr>
! 2560: <tr>
! 2561: <td class="paramkey"></td>
! 2562: <td></td>
! 2563: <td class="paramtype"><a class="el" href="confuse_8h.html#488182780ff16a94457f0d1242416154">cfg_print_func_t</a> </td>
! 2564: <td class="paramname"> <em>pf</em></td><td> </td>
! 2565: </tr>
! 2566: <tr>
! 2567: <td></td>
! 2568: <td>)</td>
! 2569: <td></td><td></td><td></td>
! 2570: </tr>
! 2571: </table>
! 2572: </div>
! 2573: <div class="memdoc">
! 2574:
! 2575: <p>
! 2576: Set a print callback function for an option given its name.
! 2577: <p>
! 2578: <dl compact><dt><b>Parameters:</b></dt><dd>
! 2579: <table border="0" cellspacing="2" cellpadding="0">
! 2580: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 2581: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option. </td></tr>
! 2582: <tr><td valign="top"></td><td valign="top"><em>pf</em> </td><td>The print callback function.</td></tr>
! 2583: </table>
! 2584: </dl>
! 2585: <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#488182780ff16a94457f0d1242416154" title="Function prototype used by the cfg_print_ functions.">cfg_print_func_t</a> </dd></dl>
! 2586:
! 2587: </div>
! 2588: </div><p>
! 2589: <a class="anchor" name="8f07eca3c5e341ee6a81ecede2fbd5d8"></a><!-- doxytag: member="confuse.h::cfg_set_validate_func" ref="8f07eca3c5e341ee6a81ecede2fbd5d8" args="(cfg_t *cfg, const char *name, cfg_validate_callback_t vf)" -->
! 2590: <div class="memitem">
! 2591: <div class="memproto">
! 2592: <table class="memname">
! 2593: <tr>
! 2594: <td class="memname">DLLIMPORT <a class="el" href="confuse_8h.html#4d01aba329210d110238d64d2047d502">cfg_validate_callback_t</a> __export cfg_set_validate_func </td>
! 2595: <td>(</td>
! 2596: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 2597: <td class="paramname"> <em>cfg</em>, </td>
! 2598: </tr>
! 2599: <tr>
! 2600: <td class="paramkey"></td>
! 2601: <td></td>
! 2602: <td class="paramtype">const char * </td>
! 2603: <td class="paramname"> <em>name</em>, </td>
! 2604: </tr>
! 2605: <tr>
! 2606: <td class="paramkey"></td>
! 2607: <td></td>
! 2608: <td class="paramtype"><a class="el" href="confuse_8h.html#4d01aba329210d110238d64d2047d502">cfg_validate_callback_t</a> </td>
! 2609: <td class="paramname"> <em>vf</em></td><td> </td>
! 2610: </tr>
! 2611: <tr>
! 2612: <td></td>
! 2613: <td>)</td>
! 2614: <td></td><td></td><td></td>
! 2615: </tr>
! 2616: </table>
! 2617: </div>
! 2618: <div class="memdoc">
! 2619:
! 2620: <p>
! 2621: Register a validating callback function for an option.
! 2622: <p>
! 2623: <dl compact><dt><b>Parameters:</b></dt><dd>
! 2624: <table border="0" cellspacing="2" cellpadding="0">
! 2625: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 2626: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option. </td></tr>
! 2627: <tr><td valign="top"></td><td valign="top"><em>vf</em> </td><td>The validating callback function.</td></tr>
! 2628: </table>
! 2629: </dl>
! 2630: <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="confuse_8h.html#4d01aba329210d110238d64d2047d502" title="Validating callback prototype.">cfg_validate_callback_t</a> </dd></dl>
! 2631: <dl compact><dt><b>Examples: </b></dt><dd>
! 2632: <a class="el" href="ftpconf_8c-example.html#a23">ftpconf.c</a>.</dl>
! 2633: <p>References <a class="el" href="confuse_8h-source.html#l00215">cfg_t::flags</a>, <a class="el" href="confuse_8h-source.html#l00219">cfg_t::opts</a>, and <a class="el" href="confuse_8h-source.html#l00270">cfg_opt_t::validcb</a>.</p>
! 2634:
! 2635: </div>
! 2636: </div><p>
! 2637: <a class="anchor" name="0c3bcf2927802380238482e6fb09fd8e"></a><!-- doxytag: member="confuse.h::cfg_setbool" ref="0c3bcf2927802380238482e6fb09fd8e" args="(cfg_t *cfg, const char *name, cfg_bool_t value)" -->
! 2638: <div class="memitem">
! 2639: <div class="memproto">
! 2640: <table class="memname">
! 2641: <tr>
! 2642: <td class="memname">DLLIMPORT void __export cfg_setbool </td>
! 2643: <td>(</td>
! 2644: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 2645: <td class="paramname"> <em>cfg</em>, </td>
! 2646: </tr>
! 2647: <tr>
! 2648: <td class="paramkey"></td>
! 2649: <td></td>
! 2650: <td class="paramtype">const char * </td>
! 2651: <td class="paramname"> <em>name</em>, </td>
! 2652: </tr>
! 2653: <tr>
! 2654: <td class="paramkey"></td>
! 2655: <td></td>
! 2656: <td class="paramtype"><a class="el" href="confuse_8h.html#4bce4b6aed9b07489d6a5c70321907e4">cfg_bool_t</a> </td>
! 2657: <td class="paramname"> <em>value</em></td><td> </td>
! 2658: </tr>
! 2659: <tr>
! 2660: <td></td>
! 2661: <td>)</td>
! 2662: <td></td><td></td><td></td>
! 2663: </tr>
! 2664: </table>
! 2665: </div>
! 2666: <div class="memdoc">
! 2667:
! 2668: <p>
! 2669: Set the value of a boolean option given its name.
! 2670: <p>
! 2671: <dl compact><dt><b>Parameters:</b></dt><dd>
! 2672: <table border="0" cellspacing="2" cellpadding="0">
! 2673: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 2674: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option. </td></tr>
! 2675: <tr><td valign="top"></td><td valign="top"><em>value</em> </td><td>The value to set. If the option is a list (the CFGF_LIST flag is set), only the first value (with index 0) is set. </td></tr>
! 2676: </table>
! 2677: </dl>
! 2678:
! 2679: </div>
! 2680: </div><p>
! 2681: <a class="anchor" name="07cc4870b50211627415d5945bf05211"></a><!-- doxytag: member="confuse.h::cfg_setfloat" ref="07cc4870b50211627415d5945bf05211" args="(cfg_t *cfg, const char *name, double value)" -->
! 2682: <div class="memitem">
! 2683: <div class="memproto">
! 2684: <table class="memname">
! 2685: <tr>
! 2686: <td class="memname">DLLIMPORT void __export cfg_setfloat </td>
! 2687: <td>(</td>
! 2688: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 2689: <td class="paramname"> <em>cfg</em>, </td>
! 2690: </tr>
! 2691: <tr>
! 2692: <td class="paramkey"></td>
! 2693: <td></td>
! 2694: <td class="paramtype">const char * </td>
! 2695: <td class="paramname"> <em>name</em>, </td>
! 2696: </tr>
! 2697: <tr>
! 2698: <td class="paramkey"></td>
! 2699: <td></td>
! 2700: <td class="paramtype">double </td>
! 2701: <td class="paramname"> <em>value</em></td><td> </td>
! 2702: </tr>
! 2703: <tr>
! 2704: <td></td>
! 2705: <td>)</td>
! 2706: <td></td><td></td><td></td>
! 2707: </tr>
! 2708: </table>
! 2709: </div>
! 2710: <div class="memdoc">
! 2711:
! 2712: <p>
! 2713: Set the value of a floating point option given its name.
! 2714: <p>
! 2715: <dl compact><dt><b>Parameters:</b></dt><dd>
! 2716: <table border="0" cellspacing="2" cellpadding="0">
! 2717: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 2718: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option. </td></tr>
! 2719: <tr><td valign="top"></td><td valign="top"><em>value</em> </td><td>The value to set. If the option is a list (the CFGF_LIST flag is set), only the first value (with index 0) is set. </td></tr>
! 2720: </table>
! 2721: </dl>
! 2722:
! 2723: </div>
! 2724: </div><p>
! 2725: <a class="anchor" name="9e145714b684d85ced96f32068ec0094"></a><!-- doxytag: member="confuse.h::cfg_setint" ref="9e145714b684d85ced96f32068ec0094" args="(cfg_t *cfg, const char *name, long int value)" -->
! 2726: <div class="memitem">
! 2727: <div class="memproto">
! 2728: <table class="memname">
! 2729: <tr>
! 2730: <td class="memname">DLLIMPORT void __export cfg_setint </td>
! 2731: <td>(</td>
! 2732: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 2733: <td class="paramname"> <em>cfg</em>, </td>
! 2734: </tr>
! 2735: <tr>
! 2736: <td class="paramkey"></td>
! 2737: <td></td>
! 2738: <td class="paramtype">const char * </td>
! 2739: <td class="paramname"> <em>name</em>, </td>
! 2740: </tr>
! 2741: <tr>
! 2742: <td class="paramkey"></td>
! 2743: <td></td>
! 2744: <td class="paramtype">long int </td>
! 2745: <td class="paramname"> <em>value</em></td><td> </td>
! 2746: </tr>
! 2747: <tr>
! 2748: <td></td>
! 2749: <td>)</td>
! 2750: <td></td><td></td><td></td>
! 2751: </tr>
! 2752: </table>
! 2753: </div>
! 2754: <div class="memdoc">
! 2755:
! 2756: <p>
! 2757: Set the value of an integer option given its name.
! 2758: <p>
! 2759: <dl compact><dt><b>Parameters:</b></dt><dd>
! 2760: <table border="0" cellspacing="2" cellpadding="0">
! 2761: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 2762: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option. </td></tr>
! 2763: <tr><td valign="top"></td><td valign="top"><em>value</em> </td><td>The value to set. If the option is a list (the CFGF_LIST flag is set), only the first value (with index 0) is set. </td></tr>
! 2764: </table>
! 2765: </dl>
! 2766:
! 2767: </div>
! 2768: </div><p>
! 2769: <a class="anchor" name="15e2a938e67dc247b3e28a20c23d1ba6"></a><!-- doxytag: member="confuse.h::cfg_setlist" ref="15e2a938e67dc247b3e28a20c23d1ba6" args="(cfg_t *cfg, const char *name, unsigned int nvalues,...)" -->
! 2770: <div class="memitem">
! 2771: <div class="memproto">
! 2772: <table class="memname">
! 2773: <tr>
! 2774: <td class="memname">DLLIMPORT void __export cfg_setlist </td>
! 2775: <td>(</td>
! 2776: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 2777: <td class="paramname"> <em>cfg</em>, </td>
! 2778: </tr>
! 2779: <tr>
! 2780: <td class="paramkey"></td>
! 2781: <td></td>
! 2782: <td class="paramtype">const char * </td>
! 2783: <td class="paramname"> <em>name</em>, </td>
! 2784: </tr>
! 2785: <tr>
! 2786: <td class="paramkey"></td>
! 2787: <td></td>
! 2788: <td class="paramtype">unsigned int </td>
! 2789: <td class="paramname"> <em>nvalues</em>, </td>
! 2790: </tr>
! 2791: <tr>
! 2792: <td class="paramkey"></td>
! 2793: <td></td>
! 2794: <td class="paramtype"> </td>
! 2795: <td class="paramname"> <em>...</em></td><td> </td>
! 2796: </tr>
! 2797: <tr>
! 2798: <td></td>
! 2799: <td>)</td>
! 2800: <td></td><td></td><td></td>
! 2801: </tr>
! 2802: </table>
! 2803: </div>
! 2804: <div class="memdoc">
! 2805:
! 2806: <p>
! 2807: Set values for a list option.
! 2808: <p>
! 2809: All existing values are replaced with the new ones.<p>
! 2810: <dl compact><dt><b>Parameters:</b></dt><dd>
! 2811: <table border="0" cellspacing="2" cellpadding="0">
! 2812: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 2813: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option. </td></tr>
! 2814: <tr><td valign="top"></td><td valign="top"><em>nvalues</em> </td><td>Number of values to set. </td></tr>
! 2815: <tr><td valign="top"></td><td valign="top"><em>...</em> </td><td>The values to set, the type must match the type of the option and the number of values must be equal to the nvalues parameter. </td></tr>
! 2816: </table>
! 2817: </dl>
! 2818:
! 2819: <p>References <a class="el" href="confuse_8h-source.html#l00083">CFGF_LIST</a>, and <a class="el" href="confuse_8h-source.html#l00262">cfg_opt_t::flags</a>.</p>
! 2820:
! 2821: </div>
! 2822: </div><p>
! 2823: <a class="anchor" name="38adad0d83e1a3d7b1f9b636e7de3bc7"></a><!-- doxytag: member="confuse.h::cfg_setnbool" ref="38adad0d83e1a3d7b1f9b636e7de3bc7" args="(cfg_t *cfg, const char *name, cfg_bool_t value, unsigned int index)" -->
! 2824: <div class="memitem">
! 2825: <div class="memproto">
! 2826: <table class="memname">
! 2827: <tr>
! 2828: <td class="memname">DLLIMPORT void __export cfg_setnbool </td>
! 2829: <td>(</td>
! 2830: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 2831: <td class="paramname"> <em>cfg</em>, </td>
! 2832: </tr>
! 2833: <tr>
! 2834: <td class="paramkey"></td>
! 2835: <td></td>
! 2836: <td class="paramtype">const char * </td>
! 2837: <td class="paramname"> <em>name</em>, </td>
! 2838: </tr>
! 2839: <tr>
! 2840: <td class="paramkey"></td>
! 2841: <td></td>
! 2842: <td class="paramtype"><a class="el" href="confuse_8h.html#4bce4b6aed9b07489d6a5c70321907e4">cfg_bool_t</a> </td>
! 2843: <td class="paramname"> <em>value</em>, </td>
! 2844: </tr>
! 2845: <tr>
! 2846: <td class="paramkey"></td>
! 2847: <td></td>
! 2848: <td class="paramtype">unsigned int </td>
! 2849: <td class="paramname"> <em>index</em></td><td> </td>
! 2850: </tr>
! 2851: <tr>
! 2852: <td></td>
! 2853: <td>)</td>
! 2854: <td></td><td></td><td></td>
! 2855: </tr>
! 2856: </table>
! 2857: </div>
! 2858: <div class="memdoc">
! 2859:
! 2860: <p>
! 2861: Set a value of a boolean option given its name and index.
! 2862: <p>
! 2863: <dl compact><dt><b>Parameters:</b></dt><dd>
! 2864: <table border="0" cellspacing="2" cellpadding="0">
! 2865: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 2866: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option. </td></tr>
! 2867: <tr><td valign="top"></td><td valign="top"><em>value</em> </td><td>The value to set. </td></tr>
! 2868: <tr><td valign="top"></td><td valign="top"><em>index</em> </td><td>The index in the option value array that should be modified. It is an error to set values with indices larger than 0 for options without the CFGF_LIST flag set. </td></tr>
! 2869: </table>
! 2870: </dl>
! 2871:
! 2872: </div>
! 2873: </div><p>
! 2874: <a class="anchor" name="179cc35df34e6a51bd7e7a20e65478e1"></a><!-- doxytag: member="confuse.h::cfg_setnfloat" ref="179cc35df34e6a51bd7e7a20e65478e1" args="(cfg_t *cfg, const char *name, double value, unsigned int index)" -->
! 2875: <div class="memitem">
! 2876: <div class="memproto">
! 2877: <table class="memname">
! 2878: <tr>
! 2879: <td class="memname">DLLIMPORT void __export cfg_setnfloat </td>
! 2880: <td>(</td>
! 2881: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 2882: <td class="paramname"> <em>cfg</em>, </td>
! 2883: </tr>
! 2884: <tr>
! 2885: <td class="paramkey"></td>
! 2886: <td></td>
! 2887: <td class="paramtype">const char * </td>
! 2888: <td class="paramname"> <em>name</em>, </td>
! 2889: </tr>
! 2890: <tr>
! 2891: <td class="paramkey"></td>
! 2892: <td></td>
! 2893: <td class="paramtype">double </td>
! 2894: <td class="paramname"> <em>value</em>, </td>
! 2895: </tr>
! 2896: <tr>
! 2897: <td class="paramkey"></td>
! 2898: <td></td>
! 2899: <td class="paramtype">unsigned int </td>
! 2900: <td class="paramname"> <em>index</em></td><td> </td>
! 2901: </tr>
! 2902: <tr>
! 2903: <td></td>
! 2904: <td>)</td>
! 2905: <td></td><td></td><td></td>
! 2906: </tr>
! 2907: </table>
! 2908: </div>
! 2909: <div class="memdoc">
! 2910:
! 2911: <p>
! 2912: Set a value of a floating point option given its name and index.
! 2913: <p>
! 2914: <dl compact><dt><b>Parameters:</b></dt><dd>
! 2915: <table border="0" cellspacing="2" cellpadding="0">
! 2916: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 2917: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option. </td></tr>
! 2918: <tr><td valign="top"></td><td valign="top"><em>value</em> </td><td>The value to set. </td></tr>
! 2919: <tr><td valign="top"></td><td valign="top"><em>index</em> </td><td>The index in the option value array that should be modified. It is an error to set values with indices larger than 0 for options without the CFGF_LIST flag set. </td></tr>
! 2920: </table>
! 2921: </dl>
! 2922:
! 2923: </div>
! 2924: </div><p>
! 2925: <a class="anchor" name="8b94a2e75abe7536ab9af8ee7c7c048b"></a><!-- doxytag: member="confuse.h::cfg_setnint" ref="8b94a2e75abe7536ab9af8ee7c7c048b" args="(cfg_t *cfg, const char *name, long int value, unsigned int index)" -->
! 2926: <div class="memitem">
! 2927: <div class="memproto">
! 2928: <table class="memname">
! 2929: <tr>
! 2930: <td class="memname">DLLIMPORT void __export cfg_setnint </td>
! 2931: <td>(</td>
! 2932: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 2933: <td class="paramname"> <em>cfg</em>, </td>
! 2934: </tr>
! 2935: <tr>
! 2936: <td class="paramkey"></td>
! 2937: <td></td>
! 2938: <td class="paramtype">const char * </td>
! 2939: <td class="paramname"> <em>name</em>, </td>
! 2940: </tr>
! 2941: <tr>
! 2942: <td class="paramkey"></td>
! 2943: <td></td>
! 2944: <td class="paramtype">long int </td>
! 2945: <td class="paramname"> <em>value</em>, </td>
! 2946: </tr>
! 2947: <tr>
! 2948: <td class="paramkey"></td>
! 2949: <td></td>
! 2950: <td class="paramtype">unsigned int </td>
! 2951: <td class="paramname"> <em>index</em></td><td> </td>
! 2952: </tr>
! 2953: <tr>
! 2954: <td></td>
! 2955: <td>)</td>
! 2956: <td></td><td></td><td></td>
! 2957: </tr>
! 2958: </table>
! 2959: </div>
! 2960: <div class="memdoc">
! 2961:
! 2962: <p>
! 2963: Set a value of an integer option given its name and index.
! 2964: <p>
! 2965: <dl compact><dt><b>Parameters:</b></dt><dd>
! 2966: <table border="0" cellspacing="2" cellpadding="0">
! 2967: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 2968: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option. </td></tr>
! 2969: <tr><td valign="top"></td><td valign="top"><em>value</em> </td><td>The value to set. </td></tr>
! 2970: <tr><td valign="top"></td><td valign="top"><em>index</em> </td><td>The index in the option value array that should be modified. It is an error to set values with indices larger than 0 for options without the CFGF_LIST flag set. </td></tr>
! 2971: </table>
! 2972: </dl>
! 2973:
! 2974: </div>
! 2975: </div><p>
! 2976: <a class="anchor" name="cbbc5f4c7667fb2555be0c6d232f9f73"></a><!-- doxytag: member="confuse.h::cfg_setnstr" ref="cbbc5f4c7667fb2555be0c6d232f9f73" args="(cfg_t *cfg, const char *name, const char *value, unsigned int index)" -->
! 2977: <div class="memitem">
! 2978: <div class="memproto">
! 2979: <table class="memname">
! 2980: <tr>
! 2981: <td class="memname">DLLIMPORT void __export cfg_setnstr </td>
! 2982: <td>(</td>
! 2983: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 2984: <td class="paramname"> <em>cfg</em>, </td>
! 2985: </tr>
! 2986: <tr>
! 2987: <td class="paramkey"></td>
! 2988: <td></td>
! 2989: <td class="paramtype">const char * </td>
! 2990: <td class="paramname"> <em>name</em>, </td>
! 2991: </tr>
! 2992: <tr>
! 2993: <td class="paramkey"></td>
! 2994: <td></td>
! 2995: <td class="paramtype">const char * </td>
! 2996: <td class="paramname"> <em>value</em>, </td>
! 2997: </tr>
! 2998: <tr>
! 2999: <td class="paramkey"></td>
! 3000: <td></td>
! 3001: <td class="paramtype">unsigned int </td>
! 3002: <td class="paramname"> <em>index</em></td><td> </td>
! 3003: </tr>
! 3004: <tr>
! 3005: <td></td>
! 3006: <td>)</td>
! 3007: <td></td><td></td><td></td>
! 3008: </tr>
! 3009: </table>
! 3010: </div>
! 3011: <div class="memdoc">
! 3012:
! 3013: <p>
! 3014: Set a value of a boolean option given its name and index.
! 3015: <p>
! 3016: <dl compact><dt><b>Parameters:</b></dt><dd>
! 3017: <table border="0" cellspacing="2" cellpadding="0">
! 3018: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 3019: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option. </td></tr>
! 3020: <tr><td valign="top"></td><td valign="top"><em>value</em> </td><td>The value to set. Memory for the string is allocated and the value is copied. Any privious string value is freed. </td></tr>
! 3021: <tr><td valign="top"></td><td valign="top"><em>index</em> </td><td>The index in the option value array that should be modified. It is an error to set values with indices larger than 0 for options without the CFGF_LIST flag set. </td></tr>
! 3022: </table>
! 3023: </dl>
! 3024:
! 3025: </div>
! 3026: </div><p>
! 3027: <a class="anchor" name="a5ad795ccedf6aeec73f5b2ec2714653"></a><!-- doxytag: member="confuse.h::cfg_setopt" ref="a5ad795ccedf6aeec73f5b2ec2714653" args="(cfg_t *cfg, cfg_opt_t *opt, char *value)" -->
! 3028: <div class="memitem">
! 3029: <div class="memproto">
! 3030: <table class="memname">
! 3031: <tr>
! 3032: <td class="memname">DLLIMPORT <a class="el" href="unioncfg__value__t.html">cfg_value_t</a>* cfg_setopt </td>
! 3033: <td>(</td>
! 3034: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 3035: <td class="paramname"> <em>cfg</em>, </td>
! 3036: </tr>
! 3037: <tr>
! 3038: <td class="paramkey"></td>
! 3039: <td></td>
! 3040: <td class="paramtype"><a class="el" href="structcfg__opt__t.html">cfg_opt_t</a> * </td>
! 3041: <td class="paramname"> <em>opt</em>, </td>
! 3042: </tr>
! 3043: <tr>
! 3044: <td class="paramkey"></td>
! 3045: <td></td>
! 3046: <td class="paramtype">char * </td>
! 3047: <td class="paramname"> <em>value</em></td><td> </td>
! 3048: </tr>
! 3049: <tr>
! 3050: <td></td>
! 3051: <td>)</td>
! 3052: <td></td><td></td><td></td>
! 3053: </tr>
! 3054: </table>
! 3055: </div>
! 3056: <div class="memdoc">
! 3057:
! 3058: <p>
! 3059: Set an option (create an instance of an option).
! 3060: <p>
! 3061: <dl compact><dt><b>Parameters:</b></dt><dd>
! 3062: <table border="0" cellspacing="2" cellpadding="0">
! 3063: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 3064: <tr><td valign="top"></td><td valign="top"><em>opt</em> </td><td>The option definition. </td></tr>
! 3065: <tr><td valign="top"></td><td valign="top"><em>value</em> </td><td>The initial value for the option.</td></tr>
! 3066: </table>
! 3067: </dl>
! 3068: <dl class="return" compact><dt><b>Returns:</b></dt><dd>Returns a pointer to the value object. </dd></dl>
! 3069:
! 3070: <p>References <a class="el" href="confuse_8h-source.html#l00234">cfg_value_t::boolean</a>, <a class="el" href="confuse_8h-source.html#l00083">CFGF_LIST</a>, <a class="el" href="confuse_8h-source.html#l00082">CFGF_MULTI</a>, <a class="el" href="confuse_8h-source.html#l00087">CFGF_NO_TITLE_DUPES</a>, <a class="el" href="confuse_8h-source.html#l00084">CFGF_NOCASE</a>, <a class="el" href="confuse_8h-source.html#l00085">CFGF_TITLE</a>, <a class="el" href="confuse_8h-source.html#l00073">CFGT_BOOL</a>, <a class="el" href="confuse_8h-source.html#l00071">CFGT_FLOAT</a>, <a class="el" href="confuse_8h-source.html#l00070">CFGT_INT</a>, <a class="el" href="confuse_8h-source.html#l00076">CFGT_PTR</a>, <a class="el" href="confuse_8h-source.html#l00074">CFGT_SEC</a>, <a class="el" href="confuse_8h-source.html#l00072">CFGT_STR</a>, <a class="el" href="confuse_8h-source.html#l00224">cfg_t::errfunc</a>, <a class="el" href="confuse_8h-source.html#l00222">cfg_t::filename</a>, <a class="el" href="confuse_8h-source.html#l00215">cfg_t::flags</a>, <a class="el" href="confuse_8h-source.html#l00262">cfg_opt_t::flags</a>, <a class="el" href="confuse_8h-source.html#l00233">cfg_value_t::fpnumber</a>, <a class="el" href="confuse_8h-source.html#l00223">cfg_t::line</a>, <a class="el" href="confuse_8h-source.html#l00216">cfg_t::name</a>, <a class="el" href="confuse_8h-source.html#l00258">cfg_opt_t::name</a>, <a class="el" href="confuse_8h-source.html#l00232">cfg_value_t::number</a>, <a class="el" href="confuse_8h-source.html#l00260">cfg_opt_t::nvalues</a>, <a class="el" href="confuse_8h-source.html#l00219">cfg_t::opts</a>, <a class="el" href="confuse_8h-source.html#l00269">cfg_opt_t::parsecb</a>, <a class="el" href="confuse_8h-source.html#l00237">cfg_value_t::ptr</a>, <a class="el" href="confuse_8h-source.html#l00236">cfg_value_t::section</a>, <a class="el" href="confuse_8h-source.html#l00266">cfg_opt_t::simple_value</a>, <a class="el" href="confuse_8h-source.html#l00235">cfg_value_t::string</a>, <a class="el" href="confuse_8h-source.html#l00263">cfg_opt_t::subopts</a>, <a class="el" href="confuse_8h-source.html#l00220">cfg_t::title</a>, <a class="el" href="confuse_8h-source.html#l00259">cfg_opt_t::type</a>, and <a class="el" href="confuse_8h-source.html#l00261">cfg_opt_t::values</a>.</p>
! 3071:
! 3072: </div>
! 3073: </div><p>
! 3074: <a class="anchor" name="dd02a10fac10c9b028c1438dff28343f"></a><!-- doxytag: member="confuse.h::cfg_setstr" ref="dd02a10fac10c9b028c1438dff28343f" args="(cfg_t *cfg, const char *name, const char *value)" -->
! 3075: <div class="memitem">
! 3076: <div class="memproto">
! 3077: <table class="memname">
! 3078: <tr>
! 3079: <td class="memname">DLLIMPORT void __export cfg_setstr </td>
! 3080: <td>(</td>
! 3081: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 3082: <td class="paramname"> <em>cfg</em>, </td>
! 3083: </tr>
! 3084: <tr>
! 3085: <td class="paramkey"></td>
! 3086: <td></td>
! 3087: <td class="paramtype">const char * </td>
! 3088: <td class="paramname"> <em>name</em>, </td>
! 3089: </tr>
! 3090: <tr>
! 3091: <td class="paramkey"></td>
! 3092: <td></td>
! 3093: <td class="paramtype">const char * </td>
! 3094: <td class="paramname"> <em>value</em></td><td> </td>
! 3095: </tr>
! 3096: <tr>
! 3097: <td></td>
! 3098: <td>)</td>
! 3099: <td></td><td></td><td></td>
! 3100: </tr>
! 3101: </table>
! 3102: </div>
! 3103: <div class="memdoc">
! 3104:
! 3105: <p>
! 3106: Set the value of a string option given its name.
! 3107: <p>
! 3108: <dl compact><dt><b>Parameters:</b></dt><dd>
! 3109: <table border="0" cellspacing="2" cellpadding="0">
! 3110: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 3111: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option. </td></tr>
! 3112: <tr><td valign="top"></td><td valign="top"><em>value</em> </td><td>The value to set. Memory for the string is allocated and the value is copied. Any previous string value is freed. If the option is a list (the CFGF_LIST flag is set), only the first value (with index 0) is set. </td></tr>
! 3113: </table>
! 3114: </dl>
! 3115: <dl compact><dt><b>Examples: </b></dt><dd>
! 3116: <a class="el" href="simple_8c-example.html#a9">simple.c</a>.</dl>
! 3117: </div>
! 3118: </div><p>
! 3119: <a class="anchor" name="cb8b2b9aa7d9e2e3c0eca67ea27bed15"></a><!-- doxytag: member="confuse.h::cfg_size" ref="cb8b2b9aa7d9e2e3c0eca67ea27bed15" args="(cfg_t *cfg, const char *name)" -->
! 3120: <div class="memitem">
! 3121: <div class="memproto">
! 3122: <table class="memname">
! 3123: <tr>
! 3124: <td class="memname">DLLIMPORT unsigned int __export cfg_size </td>
! 3125: <td>(</td>
! 3126: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 3127: <td class="paramname"> <em>cfg</em>, </td>
! 3128: </tr>
! 3129: <tr>
! 3130: <td class="paramkey"></td>
! 3131: <td></td>
! 3132: <td class="paramtype">const char * </td>
! 3133: <td class="paramname"> <em>name</em></td><td> </td>
! 3134: </tr>
! 3135: <tr>
! 3136: <td></td>
! 3137: <td>)</td>
! 3138: <td></td><td></td><td></td>
! 3139: </tr>
! 3140: </table>
! 3141: </div>
! 3142: <div class="memdoc">
! 3143:
! 3144: <p>
! 3145: Return the number of values this option has.
! 3146: <p>
! 3147: If no default value is given for the option and no value was found in the config file, 0 will be returned (ie, the option value is not set at all).<p>
! 3148: Note that there is no way to *not* specify a default value for integers, floats and booleans. Ie, they always have default values (since 0 or NULL is a valid integer/float/boolean value). Only strings and lists may have no default value.<p>
! 3149: <dl compact><dt><b>Parameters:</b></dt><dd>
! 3150: <table border="0" cellspacing="2" cellpadding="0">
! 3151: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 3152: <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name of the option. </td></tr>
! 3153: </table>
! 3154: </dl>
! 3155: <dl compact><dt><b>Examples: </b></dt><dd>
! 3156: <a class="el" href="ftpconf_8c-example.html#a8">ftpconf.c</a>, and <a class="el" href="reread_8c-example.html#a14">reread.c</a>.</dl>
! 3157: </div>
! 3158: </div><p>
! 3159: <a class="anchor" name="ccd838b44797a5a89dbfd3ab60203375"></a><!-- doxytag: member="confuse.h::cfg_tilde_expand" ref="ccd838b44797a5a89dbfd3ab60203375" args="(const char *filename)" -->
! 3160: <div class="memitem">
! 3161: <div class="memproto">
! 3162: <table class="memname">
! 3163: <tr>
! 3164: <td class="memname">DLLIMPORT char* __export cfg_tilde_expand </td>
! 3165: <td>(</td>
! 3166: <td class="paramtype">const char * </td>
! 3167: <td class="paramname"> <em>filename</em> </td>
! 3168: <td> ) </td>
! 3169: <td></td>
! 3170: </tr>
! 3171: </table>
! 3172: </div>
! 3173: <div class="memdoc">
! 3174:
! 3175: <p>
! 3176: Does tilde expansion (~ -> $HOME) on the filename.
! 3177: <p>
! 3178: <dl class="return" compact><dt><b>Returns:</b></dt><dd>The expanded filename is returned. If a ~user was not found, the original filename is returned. In any case, a dynamically allocated string is returned, which should be free()'d by the caller. </dd></dl>
! 3179:
! 3180: </div>
! 3181: </div><p>
! 3182: <a class="anchor" name="e5681800390fa1dad4b1412ef5288de7"></a><!-- doxytag: member="confuse.h::cfg_title" ref="e5681800390fa1dad4b1412ef5288de7" args="(cfg_t *cfg)" -->
! 3183: <div class="memitem">
! 3184: <div class="memproto">
! 3185: <table class="memname">
! 3186: <tr>
! 3187: <td class="memname">DLLIMPORT const char* __export cfg_title </td>
! 3188: <td>(</td>
! 3189: <td class="paramtype"><a class="el" href="structcfg__t.html">cfg_t</a> * </td>
! 3190: <td class="paramname"> <em>cfg</em> </td>
! 3191: <td> ) </td>
! 3192: <td></td>
! 3193: </tr>
! 3194: </table>
! 3195: </div>
! 3196: <div class="memdoc">
! 3197:
! 3198: <p>
! 3199: Return the title of a section.
! 3200: <p>
! 3201: <dl compact><dt><b>Parameters:</b></dt><dd>
! 3202: <table border="0" cellspacing="2" cellpadding="0">
! 3203: <tr><td valign="top"></td><td valign="top"><em>cfg</em> </td><td>The configuration file context. </td></tr>
! 3204: </table>
! 3205: </dl>
! 3206: <dl class="return" compact><dt><b>Returns:</b></dt><dd>Returns the title, or 0 if there is no title. This string should not be modified. </dd></dl>
! 3207:
! 3208: <p>References <a class="el" href="confuse_8h-source.html#l00220">cfg_t::title</a>.</p>
! 3209:
! 3210: </div>
! 3211: </div><p>
! 3212: </div>
! 3213: <!-- doxygen-footer.html starts here -->
! 3214: </div>
! 3215: </body>
! 3216: </html>
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>