1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
3
<meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"><title>ALSA project - the C library reference: /home/alsa/tmp/cvs/alsa-lib/src/confmisc.c File Reference</title>
5
<link href="doxygen.css" rel="stylesheet" type="text/css">
6
<link href="tabs.css" rel="stylesheet" type="text/css"></head><body>
7
<!-- Generated by Doxygen 1.5.0 -->
10
<li><a href="index.html"><span>Main Page</span></a></li>
11
<li><a href="modules.html"><span>Modules</span></a></li>
12
<li><a href="annotated.html"><span>Data Structures</span></a></li>
13
<li id="current"><a href="files.html"><span>Files</span></a></li>
14
<li><a href="pages.html"><span>Related Pages</span></a></li>
15
<li><a href="examples.html"><span>Examples</span></a></li>
19
<li><a href="files.html"><span>File List</span></a></li>
20
<li><a href="globals.html"><span>Globals</span></a></li>
22
<h1>/home/alsa/tmp/cvs/alsa-lib/src/confmisc.c File Reference</h1>Configuration helper functions. <a href="#_details">More...</a>
24
<table border="0" cellpadding="0" cellspacing="0">
27
<tr><td colspan="2"><br><h2>Functions</h2></td></tr>
28
<tr><td class="memItemLeft" align="right" nowrap="nowrap" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___config.html#g12afc2d09e2cb85e5550799814fb2ad6">snd_config_get_bool_ascii</a> (const char *ascii)</td></tr>
30
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the boolean value from the given ASCII string. <a href="group___config.html#g12afc2d09e2cb85e5550799814fb2ad6"></a><br></td></tr>
31
<tr><td class="memItemLeft" align="right" nowrap="nowrap" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___config.html#gf4553d6ba94b2253a42fd1a4ca154b5f">snd_config_get_bool</a> (const <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *conf)</td></tr>
33
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the boolean value from a configuration node. <a href="group___config.html#gf4553d6ba94b2253a42fd1a4ca154b5f"></a><br></td></tr>
34
<tr><td class="memItemLeft" align="right" nowrap="nowrap" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___config.html#g2d6845f40caa7daa1dea626521689ea7">snd_config_get_ctl_iface_ascii</a> (const char *ascii)</td></tr>
36
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the control interface index from the given ASCII string. <a href="group___config.html#g2d6845f40caa7daa1dea626521689ea7"></a><br></td></tr>
37
<tr><td class="memItemLeft" align="right" nowrap="nowrap" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___config.html#gb34b094eac61023dbb0cb2f62ad83cd6">snd_config_get_ctl_iface</a> (const <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *conf)</td></tr>
39
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the control interface index from a configuration node. <a href="group___config.html#gb34b094eac61023dbb0cb2f62ad83cd6"></a><br></td></tr>
40
<tr><td class="memItemLeft" align="right" nowrap="nowrap" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="confmisc_8c.html#f7ec499107acaa5df495f60a3ed0baab">snd_func_getenv</a> (<a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> **dst, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *root, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *src, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *private_data)</td></tr>
42
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns an environment value. <a href="#f7ec499107acaa5df495f60a3ed0baab"></a><br></td></tr>
43
<tr><td class="memItemLeft" align="right" nowrap="nowrap" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="confmisc_8c.html#bc79b425493bc519d8dfb28f558a1b56">snd_func_igetenv</a> (<a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> **dst, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *root, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *src, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *private_data)</td></tr>
45
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns an integer environment value. <a href="#bc79b425493bc519d8dfb28f558a1b56"></a><br></td></tr>
46
<tr><td class="memItemLeft" align="right" nowrap="nowrap" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="confmisc_8c.html#ed280a38060f20c94a38b11673a2d447">snd_func_concat</a> (<a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> **dst, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *root, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *src, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *private_data)</td></tr>
48
<tr><td class="mdescLeft"> </td><td class="mdescRight">Merges the given strings. <a href="#ed280a38060f20c94a38b11673a2d447"></a><br></td></tr>
49
<tr><td class="memItemLeft" align="right" nowrap="nowrap" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="confmisc_8c.html#e0c9a32ea9efa18253b01c6e4074f492">snd_func_iadd</a> (<a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> **dst, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *root, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *src, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *private_data)</td></tr>
51
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sum the given integers. <a href="#e0c9a32ea9efa18253b01c6e4074f492"></a><br></td></tr>
52
<tr><td class="memItemLeft" align="right" nowrap="nowrap" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="confmisc_8c.html#73a4d651e6170f469506b4f8bdc5b6ea">snd_func_imul</a> (<a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> **dst, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *root, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *src, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *private_data)</td></tr>
54
<tr><td class="mdescLeft"> </td><td class="mdescRight">Multiply the given integers. <a href="#73a4d651e6170f469506b4f8bdc5b6ea"></a><br></td></tr>
55
<tr><td class="memItemLeft" align="right" nowrap="nowrap" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="confmisc_8c.html#2e969b10deff19e167e933bd6c8f3a9e">snd_func_datadir</a> (<a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> **dst, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *root, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *src, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *private_data)</td></tr>
57
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the ALSA data directory. <a href="#2e969b10deff19e167e933bd6c8f3a9e"></a><br></td></tr>
58
<tr><td class="memItemLeft" align="right" nowrap="nowrap" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="confmisc_8c.html#a3eafc76e97d2b95a371df5877e5192b">snd_func_private_string</a> (<a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> **dst, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *root, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *src, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *private_data)</td></tr>
60
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the string from <code>private_data</code>. <a href="#a3eafc76e97d2b95a371df5877e5192b"></a><br></td></tr>
61
<tr><td class="memItemLeft" align="right" nowrap="nowrap" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="confmisc_8c.html#8582f357991b7419a51df939e82e12f5">snd_func_private_card_driver</a> (<a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> **dst, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *root, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *src, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *private_data)</td></tr>
63
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the driver identification from <code>private_data</code>. <a href="#8582f357991b7419a51df939e82e12f5"></a><br></td></tr>
64
<tr><td class="memItemLeft" align="right" nowrap="nowrap" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="confmisc_8c.html#274b9e43079c594856e6f40a776053e1">snd_func_card_inum</a> (<a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> **dst, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *root, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *src, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *private_data)</td></tr>
66
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the card number as integer. <a href="#274b9e43079c594856e6f40a776053e1"></a><br></td></tr>
67
<tr><td class="memItemLeft" align="right" nowrap="nowrap" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="confmisc_8c.html#c44dfe2030edbe544e037e17350c328f">snd_func_card_driver</a> (<a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> **dst, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *root, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *src, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *private_data)</td></tr>
69
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the driver identification for a card. <a href="#c44dfe2030edbe544e037e17350c328f"></a><br></td></tr>
70
<tr><td class="memItemLeft" align="right" nowrap="nowrap" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="confmisc_8c.html#75d71399c42dc0ea9afff8a51bad7141">snd_func_card_id</a> (<a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> **dst, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *root, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *src, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *private_data)</td></tr>
72
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the identification of a card. <a href="#75d71399c42dc0ea9afff8a51bad7141"></a><br></td></tr>
73
<tr><td class="memItemLeft" align="right" nowrap="nowrap" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="confmisc_8c.html#69ac7a43d118d166435e5d464d222864">snd_func_card_name</a> (<a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> **dst, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *root, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *src, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *private_data)</td></tr>
75
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the name of a card. <a href="#69ac7a43d118d166435e5d464d222864"></a><br></td></tr>
76
<tr><td class="memItemLeft" align="right" nowrap="nowrap" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="confmisc_8c.html#cfe1291b1268b49b206b852d463f7ead">snd_func_refer</a> (<a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> **dst, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *root, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *src, <a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> *private_data)</td></tr>
78
<tr><td class="mdescLeft"> </td><td class="mdescRight">Copies the specified configuration node. <a href="#cfe1291b1268b49b206b852d463f7ead"></a><br></td></tr>
80
</p><hr><a name="_details"></a><h2>Detailed Description</h2>
81
Configuration helper functions.
83
</p><dl class="author" compact="compact"><dt><b>Author:</b></dt><dd>Abramo Bagnara <<a href="mailto:abramo@alsa-project.org">abramo@alsa-project.org</a>> <p>
84
Jaroslav Kysela <<a href="mailto:perex@perex.cz">perex@perex.cz</a>> </p></dd></dl>
85
<dl class="date" compact="compact"><dt><b>Date:</b></dt><dd>2000-2001</dd></dl>
86
Configuration helper functions.<p>
87
See the <a class="el" href="conffunc.html">Runtime functions in configuration files</a> page for more details. </p><hr><h2>Function Documentation</h2>
88
<a class="anchor" name="c44dfe2030edbe544e037e17350c328f"></a><!-- doxytag: member="confmisc.c::snd_func_card_driver" ref="c44dfe2030edbe544e037e17350c328f" args="(snd_config_t **dst, snd_config_t *root, snd_config_t *src, snd_config_t *private_data)" -->
90
<div class="memproto">
91
<table class="memname">
93
<td class="memname">int snd_func_card_driver </td>
95
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> ** </td>
96
<td class="paramname"> <em>dst</em>, </td>
99
<td class="paramkey"><br>
103
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
104
<td class="paramname"> <em>root</em>, </td>
107
<td class="paramkey"><br>
111
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
112
<td class="paramname"> <em>src</em>, </td>
115
<td class="paramkey"><br>
119
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
120
<td class="paramname"> <em>private_data</em></td><td> </td>
128
</td><td width="100%"><br>
136
Returns the driver identification for a card.
138
</p><dl compact="compact"><dt><b>Parameters:</b></dt><dd>
139
<table border="0" cellpadding="0" cellspacing="2">
140
<tbody><tr><td valign="top"><br>
141
</td><td valign="top"><em>dst</em> </td><td>The function puts the handle to the result configuration node (with type string) at the address specified by <code>dst</code>. </td></tr>
142
<tr><td valign="top"><br>
143
</td><td valign="top"><em>root</em> </td><td>Handle to the root source node. </td></tr>
144
<tr><td valign="top"><br>
145
</td><td valign="top"><em>src</em> </td><td>Handle to the source node, with a <code>card</code> definition. </td></tr>
146
<tr><td valign="top"><br>
147
</td><td valign="top"><em>private_data</em> </td><td>Handle to the <code>private_data</code> node. </td></tr>
150
<dl class="return" compact="compact"><dt><b>Returns:</b></dt><dd>A non-negative value if successful, otherwise a negative error code.</dd></dl>
151
Example: <div class="fragment"><pre class="fragment"> {<br> @func card_driver<br> card 0<br> }<br></pre></div>
154
<a class="anchor" name="75d71399c42dc0ea9afff8a51bad7141"></a><!-- doxytag: member="confmisc.c::snd_func_card_id" ref="75d71399c42dc0ea9afff8a51bad7141" args="(snd_config_t **dst, snd_config_t *root, snd_config_t *src, snd_config_t *private_data)" -->
155
</p><div class="memitem">
156
<div class="memproto">
157
<table class="memname">
159
<td class="memname">int snd_func_card_id </td>
161
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> ** </td>
162
<td class="paramname"> <em>dst</em>, </td>
165
<td class="paramkey"><br>
169
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
170
<td class="paramname"> <em>root</em>, </td>
173
<td class="paramkey"><br>
177
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
178
<td class="paramname"> <em>src</em>, </td>
181
<td class="paramkey"><br>
185
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
186
<td class="paramname"> <em>private_data</em></td><td> </td>
194
</td><td width="100%"><br>
202
Returns the identification of a card.
204
</p><dl compact="compact"><dt><b>Parameters:</b></dt><dd>
205
<table border="0" cellpadding="0" cellspacing="2">
206
<tbody><tr><td valign="top"><br>
207
</td><td valign="top"><em>dst</em> </td><td>The function puts the handle to the result configuration node (with type string) at the address specified by <code>dst</code>. </td></tr>
208
<tr><td valign="top"><br>
209
</td><td valign="top"><em>root</em> </td><td>Handle to the root source node. </td></tr>
210
<tr><td valign="top"><br>
211
</td><td valign="top"><em>src</em> </td><td>Handle to the source node, with a <code>card</code> definition. </td></tr>
212
<tr><td valign="top"><br>
213
</td><td valign="top"><em>private_data</em> </td><td>Handle to the <code>private_data</code> node. </td></tr>
216
<dl class="return" compact="compact"><dt><b>Returns:</b></dt><dd>A non-negative value if successful, otherwise a negative error code.</dd></dl>
217
Example: <div class="fragment"><pre class="fragment"> {<br> @func card_id<br> card 0<br> }<br></pre></div>
220
<a class="anchor" name="274b9e43079c594856e6f40a776053e1"></a><!-- doxytag: member="confmisc.c::snd_func_card_inum" ref="274b9e43079c594856e6f40a776053e1" args="(snd_config_t **dst, snd_config_t *root, snd_config_t *src, snd_config_t *private_data)" -->
221
</p><div class="memitem">
222
<div class="memproto">
223
<table class="memname">
225
<td class="memname">int snd_func_card_inum </td>
227
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> ** </td>
228
<td class="paramname"> <em>dst</em>, </td>
231
<td class="paramkey"><br>
235
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
236
<td class="paramname"> <em>root</em>, </td>
239
<td class="paramkey"><br>
243
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
244
<td class="paramname"> <em>src</em>, </td>
247
<td class="paramkey"><br>
251
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
252
<td class="paramname"> <em>private_data</em></td><td> </td>
260
</td><td width="100%"><br>
268
Returns the card number as integer.
270
</p><dl compact="compact"><dt><b>Parameters:</b></dt><dd>
271
<table border="0" cellpadding="0" cellspacing="2">
272
<tbody><tr><td valign="top"><br>
273
</td><td valign="top"><em>dst</em> </td><td>The function puts the handle to the result configuration node (with type string) at the address specified by <code>dst</code>. </td></tr>
274
<tr><td valign="top"><br>
275
</td><td valign="top"><em>root</em> </td><td>Handle to the root source node. </td></tr>
276
<tr><td valign="top"><br>
277
</td><td valign="top"><em>src</em> </td><td>Handle to the source node, with a <code>card</code> definition. </td></tr>
278
<tr><td valign="top"><br>
279
</td><td valign="top"><em>private_data</em> </td><td>Handle to the <code>private_data</code> node. </td></tr>
282
<dl class="return" compact="compact"><dt><b>Returns:</b></dt><dd>A non-negative value if successful, otherwise a negative error code.</dd></dl>
283
Example: <div class="fragment"><pre class="fragment"> {<br> @func card_inum<br> card <span class="charliteral">'0'</span>
288
<a class="anchor" name="69ac7a43d118d166435e5d464d222864"></a><!-- doxytag: member="confmisc.c::snd_func_card_name" ref="69ac7a43d118d166435e5d464d222864" args="(snd_config_t **dst, snd_config_t *root, snd_config_t *src, snd_config_t *private_data)" -->
289
</p><div class="memitem">
290
<div class="memproto">
291
<table class="memname">
293
<td class="memname">int snd_func_card_name </td>
295
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> ** </td>
296
<td class="paramname"> <em>dst</em>, </td>
299
<td class="paramkey"><br>
303
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
304
<td class="paramname"> <em>root</em>, </td>
307
<td class="paramkey"><br>
311
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
312
<td class="paramname"> <em>src</em>, </td>
315
<td class="paramkey"><br>
319
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
320
<td class="paramname"> <em>private_data</em></td><td> </td>
328
</td><td width="100%"><br>
336
Returns the name of a card.
338
</p><dl compact="compact"><dt><b>Parameters:</b></dt><dd>
339
<table border="0" cellpadding="0" cellspacing="2">
340
<tbody><tr><td valign="top"><br>
341
</td><td valign="top"><em>dst</em> </td><td>The function puts the handle to the result configuration node (with type string) at the address specified by <code>dst</code>. </td></tr>
342
<tr><td valign="top"><br>
343
</td><td valign="top"><em>root</em> </td><td>Handle to the root source node. </td></tr>
344
<tr><td valign="top"><br>
345
</td><td valign="top"><em>src</em> </td><td>Handle to the source node, with a <code>card</code> definition. </td></tr>
346
<tr><td valign="top"><br>
347
</td><td valign="top"><em>private_data</em> </td><td>Handle to the <code>private_data</code> node. </td></tr>
350
<dl class="return" compact="compact"><dt><b>Returns:</b></dt><dd>A non-negative value if successful, otherwise a negative error code.</dd></dl>
351
Example: <div class="fragment"><pre class="fragment"> {<br> @func card_name<br> card 0<br> }<br></pre></div>
354
<a class="anchor" name="ed280a38060f20c94a38b11673a2d447"></a><!-- doxytag: member="confmisc.c::snd_func_concat" ref="ed280a38060f20c94a38b11673a2d447" args="(snd_config_t **dst, snd_config_t *root, snd_config_t *src, snd_config_t *private_data)" -->
355
</p><div class="memitem">
356
<div class="memproto">
357
<table class="memname">
359
<td class="memname">int snd_func_concat </td>
361
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> ** </td>
362
<td class="paramname"> <em>dst</em>, </td>
365
<td class="paramkey"><br>
369
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
370
<td class="paramname"> <em>root</em>, </td>
373
<td class="paramkey"><br>
377
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
378
<td class="paramname"> <em>src</em>, </td>
381
<td class="paramkey"><br>
385
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
386
<td class="paramname"> <em>private_data</em></td><td> </td>
394
</td><td width="100%"><br>
402
Merges the given strings.
404
</p><dl compact="compact"><dt><b>Parameters:</b></dt><dd>
405
<table border="0" cellpadding="0" cellspacing="2">
406
<tbody><tr><td valign="top"><br>
407
</td><td valign="top"><em>dst</em> </td><td>The function puts the handle to the result configuration node (with type string) at the address specified by <code>dst</code>. </td></tr>
408
<tr><td valign="top"><br>
409
</td><td valign="top"><em>root</em> </td><td>Handle to the root source node. </td></tr>
410
<tr><td valign="top"><br>
411
</td><td valign="top"><em>src</em> </td><td>Handle to the source node, with a definition for <code>strings</code>. </td></tr>
412
<tr><td valign="top"><br>
413
</td><td valign="top"><em>private_data</em> </td><td>Handle to the <code>private_data</code> node. </td></tr>
416
<dl class="return" compact="compact"><dt><b>Returns:</b></dt><dd>A non-negative value if successful, otherwise a negative error code.</dd></dl>
417
Example (result is "a1b2c3"): <div class="fragment"><pre class="fragment"> {<br> @func concat<br> strings [ <span class="stringliteral">"a1"</span> <span class="stringliteral">"b2"</span> <span class="stringliteral">"c3"</span> ]<br> }<br></pre></div>
420
<a class="anchor" name="2e969b10deff19e167e933bd6c8f3a9e"></a><!-- doxytag: member="confmisc.c::snd_func_datadir" ref="2e969b10deff19e167e933bd6c8f3a9e" args="(snd_config_t **dst, snd_config_t *root, snd_config_t *src, snd_config_t *private_data)" -->
421
</p><div class="memitem">
422
<div class="memproto">
423
<table class="memname">
425
<td class="memname">int snd_func_datadir </td>
427
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> ** </td>
428
<td class="paramname"> <em>dst</em>, </td>
431
<td class="paramkey"><br>
435
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
436
<td class="paramname"> <em>root</em>, </td>
439
<td class="paramkey"><br>
443
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
444
<td class="paramname"> <em>src</em>, </td>
447
<td class="paramkey"><br>
451
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
452
<td class="paramname"> <em>private_data</em></td><td> </td>
460
</td><td width="100%"><br>
468
Returns the ALSA data directory.
470
</p><dl compact="compact"><dt><b>Parameters:</b></dt><dd>
471
<table border="0" cellpadding="0" cellspacing="2">
472
<tbody><tr><td valign="top"><br>
473
</td><td valign="top"><em>dst</em> </td><td>The function puts the handle to the result configuration node (with type string) at the address specified by <code>dst</code>. </td></tr>
474
<tr><td valign="top"><br>
475
</td><td valign="top"><em>root</em> </td><td>Handle to the root source node. </td></tr>
476
<tr><td valign="top"><br>
477
</td><td valign="top"><em>src</em> </td><td>Handle to the source node. </td></tr>
478
<tr><td valign="top"><br>
479
</td><td valign="top"><em>private_data</em> </td><td>Handle to the <code>private_data</code> node. Not used. </td></tr>
482
<dl class="return" compact="compact"><dt><b>Returns:</b></dt><dd>A non-negative value if successful, otherwise a negative error code.</dd></dl>
483
Example (result is "/usr/share/alsa" using the default paths): <div class="fragment"><pre class="fragment"> {<br> @func datadir<br> }<br></pre></div>
486
<a class="anchor" name="f7ec499107acaa5df495f60a3ed0baab"></a><!-- doxytag: member="confmisc.c::snd_func_getenv" ref="f7ec499107acaa5df495f60a3ed0baab" args="(snd_config_t **dst, snd_config_t *root, snd_config_t *src, snd_config_t *private_data)" -->
487
</p><div class="memitem">
488
<div class="memproto">
489
<table class="memname">
491
<td class="memname">int snd_func_getenv </td>
493
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> ** </td>
494
<td class="paramname"> <em>dst</em>, </td>
497
<td class="paramkey"><br>
501
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
502
<td class="paramname"> <em>root</em>, </td>
505
<td class="paramkey"><br>
509
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
510
<td class="paramname"> <em>src</em>, </td>
513
<td class="paramkey"><br>
517
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
518
<td class="paramname"> <em>private_data</em></td><td> </td>
526
</td><td width="100%"><br>
534
Returns an environment value.
536
</p><dl compact="compact"><dt><b>Parameters:</b></dt><dd>
537
<table border="0" cellpadding="0" cellspacing="2">
538
<tbody><tr><td valign="top"><br>
539
</td><td valign="top"><em>dst</em> </td><td>The function puts the handle to the result configuration node (with type string) at the address specified by <code>dst</code>. </td></tr>
540
<tr><td valign="top"><br>
541
</td><td valign="top"><em>root</em> </td><td>Handle to the root source node. </td></tr>
542
<tr><td valign="top"><br>
543
</td><td valign="top"><em>src</em> </td><td>Handle to the source node, with definitions for <code>vars</code> and <code>default</code>. </td></tr>
544
<tr><td valign="top"><br>
545
</td><td valign="top"><em>private_data</em> </td><td>Handle to the <code>private_data</code> node. </td></tr>
548
<dl class="return" compact="compact"><dt><b>Returns:</b></dt><dd>Zero if successful, otherwise a negative error code.</dd></dl>
549
Example: <div class="fragment"><pre class="fragment"> {<br> @func getenv<br> vars [ MY_CARD CARD C ]<br> <span class="keywordflow">default</span> 0<br> }<br></pre></div>
552
<a class="anchor" name="e0c9a32ea9efa18253b01c6e4074f492"></a><!-- doxytag: member="confmisc.c::snd_func_iadd" ref="e0c9a32ea9efa18253b01c6e4074f492" args="(snd_config_t **dst, snd_config_t *root, snd_config_t *src, snd_config_t *private_data)" -->
553
</p><div class="memitem">
554
<div class="memproto">
555
<table class="memname">
557
<td class="memname">int snd_func_iadd </td>
559
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> ** </td>
560
<td class="paramname"> <em>dst</em>, </td>
563
<td class="paramkey"><br>
567
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
568
<td class="paramname"> <em>root</em>, </td>
571
<td class="paramkey"><br>
575
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
576
<td class="paramname"> <em>src</em>, </td>
579
<td class="paramkey"><br>
583
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
584
<td class="paramname"> <em>private_data</em></td><td> </td>
592
</td><td width="100%"><br>
600
Sum the given integers.
602
</p><dl compact="compact"><dt><b>Parameters:</b></dt><dd>
603
<table border="0" cellpadding="0" cellspacing="2">
604
<tbody><tr><td valign="top"><br>
605
</td><td valign="top"><em>dst</em> </td><td>The function puts the handle to the result configuration node (with type integer) at the address specified by <code>dst</code>. </td></tr>
606
<tr><td valign="top"><br>
607
</td><td valign="top"><em>root</em> </td><td>Handle to the root source node. </td></tr>
608
<tr><td valign="top"><br>
609
</td><td valign="top"><em>src</em> </td><td>Handle to the source node, with a definition for <code>integers</code>. </td></tr>
610
<tr><td valign="top"><br>
611
</td><td valign="top"><em>private_data</em> </td><td>Handle to the <code>private_data</code> node. </td></tr>
614
<dl class="return" compact="compact"><dt><b>Returns:</b></dt><dd>A non-negative value if successful, otherwise a negative error code.</dd></dl>
615
Example (result is 10): <div class="fragment"><pre class="fragment"> {<br> @func iadd<br> integers [ 2 3 5 ]<br> }<br></pre></div>
618
<a class="anchor" name="bc79b425493bc519d8dfb28f558a1b56"></a><!-- doxytag: member="confmisc.c::snd_func_igetenv" ref="bc79b425493bc519d8dfb28f558a1b56" args="(snd_config_t **dst, snd_config_t *root, snd_config_t *src, snd_config_t *private_data)" -->
619
</p><div class="memitem">
620
<div class="memproto">
621
<table class="memname">
623
<td class="memname">int snd_func_igetenv </td>
625
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> ** </td>
626
<td class="paramname"> <em>dst</em>, </td>
629
<td class="paramkey"><br>
633
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
634
<td class="paramname"> <em>root</em>, </td>
637
<td class="paramkey"><br>
641
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
642
<td class="paramname"> <em>src</em>, </td>
645
<td class="paramkey"><br>
649
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
650
<td class="paramname"> <em>private_data</em></td><td> </td>
658
</td><td width="100%"><br>
666
Returns an integer environment value.
668
</p><dl compact="compact"><dt><b>Parameters:</b></dt><dd>
669
<table border="0" cellpadding="0" cellspacing="2">
670
<tbody><tr><td valign="top"><br>
671
</td><td valign="top"><em>dst</em> </td><td>The function puts the handle to the result configuration node (with type integer) at the address specified by <code>dst</code>. </td></tr>
672
<tr><td valign="top"><br>
673
</td><td valign="top"><em>root</em> </td><td>Handle to the root source node. </td></tr>
674
<tr><td valign="top"><br>
675
</td><td valign="top"><em>src</em> </td><td>Handle to the source node, with definitions for <code>vars</code> and <code>default</code>. </td></tr>
676
<tr><td valign="top"><br>
677
</td><td valign="top"><em>private_data</em> </td><td>Handle to the <code>private_data</code> node. </td></tr>
680
<dl class="return" compact="compact"><dt><b>Returns:</b></dt><dd>Zero if successful, otherwise a negative error code.</dd></dl>
681
Example: <div class="fragment"><pre class="fragment"> {<br> @func igetenv<br> vars [ MY_DEVICE DEVICE D ]<br> <span class="keywordflow">default</span> 0<br> }<br></pre></div>
684
<a class="anchor" name="73a4d651e6170f469506b4f8bdc5b6ea"></a><!-- doxytag: member="confmisc.c::snd_func_imul" ref="73a4d651e6170f469506b4f8bdc5b6ea" args="(snd_config_t **dst, snd_config_t *root, snd_config_t *src, snd_config_t *private_data)" -->
685
</p><div class="memitem">
686
<div class="memproto">
687
<table class="memname">
689
<td class="memname">int snd_func_imul </td>
691
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> ** </td>
692
<td class="paramname"> <em>dst</em>, </td>
695
<td class="paramkey"><br>
699
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
700
<td class="paramname"> <em>root</em>, </td>
703
<td class="paramkey"><br>
707
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
708
<td class="paramname"> <em>src</em>, </td>
711
<td class="paramkey"><br>
715
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
716
<td class="paramname"> <em>private_data</em></td><td> </td>
724
</td><td width="100%"><br>
732
Multiply the given integers.
734
</p><dl compact="compact"><dt><b>Parameters:</b></dt><dd>
735
<table border="0" cellpadding="0" cellspacing="2">
736
<tbody><tr><td valign="top"><br>
737
</td><td valign="top"><em>dst</em> </td><td>The function puts the handle to the result configuration node (with type integer) at the address specified by <code>dst</code>. </td></tr>
738
<tr><td valign="top"><br>
739
</td><td valign="top"><em>root</em> </td><td>Handle to the root source node. </td></tr>
740
<tr><td valign="top"><br>
741
</td><td valign="top"><em>src</em> </td><td>Handle to the source node, with a definition for <code>integers</code>. </td></tr>
742
<tr><td valign="top"><br>
743
</td><td valign="top"><em>private_data</em> </td><td>Handle to the <code>private_data</code> node. </td></tr>
746
<dl class="return" compact="compact"><dt><b>Returns:</b></dt><dd>A non-negative value if successful, otherwise a negative error code.</dd></dl>
747
Example (result is 12): <div class="fragment"><pre class="fragment"> {<br> @func imul<br> integers [ 2 3 2 ]<br> }<br></pre></div>
750
<a class="anchor" name="8582f357991b7419a51df939e82e12f5"></a><!-- doxytag: member="confmisc.c::snd_func_private_card_driver" ref="8582f357991b7419a51df939e82e12f5" args="(snd_config_t **dst, snd_config_t *root, snd_config_t *src, snd_config_t *private_data)" -->
751
</p><div class="memitem">
752
<div class="memproto">
753
<table class="memname">
755
<td class="memname">int snd_func_private_card_driver </td>
757
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> ** </td>
758
<td class="paramname"> <em>dst</em>, </td>
761
<td class="paramkey"><br>
765
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
766
<td class="paramname"> <em>root</em>, </td>
769
<td class="paramkey"><br>
773
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
774
<td class="paramname"> <em>src</em>, </td>
777
<td class="paramkey"><br>
781
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
782
<td class="paramname"> <em>private_data</em></td><td> </td>
790
</td><td width="100%"><br>
798
Returns the driver identification from <code>private_data</code>.
800
</p><dl compact="compact"><dt><b>Parameters:</b></dt><dd>
801
<table border="0" cellpadding="0" cellspacing="2">
802
<tbody><tr><td valign="top"><br>
803
</td><td valign="top"><em>dst</em> </td><td>The function puts the handle to the result configuration node (with type string) at the address specified by <code>dst</code>. </td></tr>
804
<tr><td valign="top"><br>
805
</td><td valign="top"><em>root</em> </td><td>Handle to the root source node. </td></tr>
806
<tr><td valign="top"><br>
807
</td><td valign="top"><em>src</em> </td><td>Handle to the source node. </td></tr>
808
<tr><td valign="top"><br>
809
</td><td valign="top"><em>private_data</em> </td><td>Handle to the <code>private_data</code> node (type integer, id "card"). </td></tr>
812
<dl class="return" compact="compact"><dt><b>Returns:</b></dt><dd>A non-negative value if successful, otherwise a negative error code.</dd></dl>
813
Example: <div class="fragment"><pre class="fragment"> {<br> @func private_card_driver<br> }<br></pre></div>
816
<a class="anchor" name="a3eafc76e97d2b95a371df5877e5192b"></a><!-- doxytag: member="confmisc.c::snd_func_private_string" ref="a3eafc76e97d2b95a371df5877e5192b" args="(snd_config_t **dst, snd_config_t *root, snd_config_t *src, snd_config_t *private_data)" -->
817
</p><div class="memitem">
818
<div class="memproto">
819
<table class="memname">
821
<td class="memname">int snd_func_private_string </td>
823
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> ** </td>
824
<td class="paramname"> <em>dst</em>, </td>
827
<td class="paramkey"><br>
831
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
832
<td class="paramname"> <em>root</em>, </td>
835
<td class="paramkey"><br>
839
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
840
<td class="paramname"> <em>src</em>, </td>
843
<td class="paramkey"><br>
847
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
848
<td class="paramname"> <em>private_data</em></td><td> </td>
856
</td><td width="100%"><br>
864
Returns the string from <code>private_data</code>.
866
</p><dl compact="compact"><dt><b>Parameters:</b></dt><dd>
867
<table border="0" cellpadding="0" cellspacing="2">
868
<tbody><tr><td valign="top"><br>
869
</td><td valign="top"><em>dst</em> </td><td>The function puts the handle to the result configuration node (with type string) at the address specified by <code>dst</code>. </td></tr>
870
<tr><td valign="top"><br>
871
</td><td valign="top"><em>root</em> </td><td>Handle to the root source node. </td></tr>
872
<tr><td valign="top"><br>
873
</td><td valign="top"><em>src</em> </td><td>Handle to the source node. </td></tr>
874
<tr><td valign="top"><br>
875
</td><td valign="top"><em>private_data</em> </td><td>Handle to the <code>private_data</code> node (type string, id "string"). </td></tr>
878
<dl class="return" compact="compact"><dt><b>Returns:</b></dt><dd>A non-negative value if successful, otherwise a negative error code.</dd></dl>
879
Example: <div class="fragment"><pre class="fragment"> {<br> @func private_string<br> }<br></pre></div>
882
<a class="anchor" name="cfe1291b1268b49b206b852d463f7ead"></a><!-- doxytag: member="confmisc.c::snd_func_refer" ref="cfe1291b1268b49b206b852d463f7ead" args="(snd_config_t **dst, snd_config_t *root, snd_config_t *src, snd_config_t *private_data)" -->
883
</p><div class="memitem">
884
<div class="memproto">
885
<table class="memname">
887
<td class="memname">int snd_func_refer </td>
889
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> ** </td>
890
<td class="paramname"> <em>dst</em>, </td>
893
<td class="paramkey"><br>
897
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
898
<td class="paramname"> <em>root</em>, </td>
901
<td class="paramkey"><br>
905
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
906
<td class="paramname"> <em>src</em>, </td>
909
<td class="paramkey"><br>
913
<td class="paramtype"><a class="el" href="group___config.html#gb7dc173feea5bedcd999bba678eb53a7">snd_config_t</a> * </td>
914
<td class="paramname"> <em>private_data</em></td><td> </td>
922
</td><td width="100%"><br>
930
Copies the specified configuration node.
932
</p><dl compact="compact"><dt><b>Parameters:</b></dt><dd>
933
<table border="0" cellpadding="0" cellspacing="2">
934
<tbody><tr><td valign="top"><br>
935
</td><td valign="top"><em>dst</em> </td><td>The function puts the
936
handle to the result configuration node (with the same type as the
937
specified node) at the address specified by <code>dst</code>. </td></tr>
938
<tr><td valign="top"><br>
939
</td><td valign="top"><em>root</em> </td><td>Handle to the root source node. </td></tr>
940
<tr><td valign="top"><br>
941
</td><td valign="top"><em>src</em> </td><td>Handle to the source node, with definitions for <code>name</code> and (optionally) <code>file</code>. </td></tr>
942
<tr><td valign="top"><br>
943
</td><td valign="top"><em>private_data</em> </td><td>Handle to the <code>private_data</code> node. </td></tr>
946
<dl class="return" compact="compact"><dt><b>Returns:</b></dt><dd>A non-negative value if successful, otherwise a negative error code. </dd></dl>
947
<dl class="note" compact="compact"><dt><b>Note:</b></dt><dd>The root source node can be modified!</dd></dl>
948
Example: <div class="fragment"><pre class="fragment"> {<br> @func refer<br> file <span class="stringliteral">"/etc/myconf.conf"</span> # optional<br> name <span class="stringliteral">"id1.id2.id3"</span>
953
</p><hr size="1"><address style=""><small>Generated on Wed Sep 9 14:37:08 2009 for ALSA project - the C library reference by
954
<a href="http://www.doxygen.org/index.html">
955
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.0 </small></address>
b'\\ No newline at end of file'