| version 1.9, 2002/09/02 15:01:06 |
version 1.10, 2002/09/02 15:30:23 |
|
|
| <!-- MAN: <refsect1><title>SYNOPSIS</title> --> |
<!-- MAN: <refsect1><title>SYNOPSIS</title> --> |
| <para> |
<para> |
| |
|
| These functions are used manipulating with error. &name; itself remember last |
These functions are used for manipulation with &name; errors. Parsing context |
| occured error in internal data structures. |
(<structname>cfg_context</structname>) itself remembers last occured error in |
| |
internal data structures. |
| |
|
| <funcsynopsis> |
<funcsynopsis> |
| <funcsynopsisinfo><![CDATA[#include <cfg+.h>]]></funcsynopsisinfo> |
<funcsynopsisinfo><![CDATA[#include <cfg+.h>]]></funcsynopsisinfo> |
| Line 62 occured error in internal data structure |
|
| Line 63 occured error in internal data structure |
|
| <para> |
<para> |
| |
|
| Function <function>cfg_print_error()</function> prints error message of last |
Function <function>cfg_print_error()</function> prints error message of last |
| error. Similar function <function>cfg_fprint_error()</function> prints error |
occured error. Similar function <function>cfg_fprint_error()</function> prints |
| message to specified stream as second parameter <parameter>fh</parameter>. |
error message to specified stream, which must be passed as second parameter |
| |
<parameter>fh</parameter>. |
| |
|
| </para> |
</para> |
| <para> |
<para> |
| |
|
| The last error manipulating function, <function>cfg_get_error_str()</function>, |
The last error manipulating function, <function>cfg_get_error_str()</function>, |
| returns error message string. String is dynamically allocated. It is |
returns error message string. String is dynamically allocated. It is |
| <constant>NUL</constant> terminated array of characters filled with error |
<constant>NULL</constant> terminated array of characters filled with error |
| message. Returned pointer must be freed using <function>free()</function> system |
message. Returned pointer must be freed using <function>free()</function> system |
| call. |
call. |
| |
|
| Line 199 linkend="usage.parsing" endterm="usage.p |
|
| Line 201 linkend="usage.parsing" endterm="usage.p |
|
| </para> |
</para> |
| <para> |
<para> |
| |
|
| All constants are provided also in their shorter forms. Use |
All constants exist also in their shorter forms. Use <constant>_ERR_</constant> |
| <constant>_ERR_</constant> substring in constant name instead |
substring in constant name instead <constant>_ERROR_</constant> substring. So |
| <constant>_ERROR_</constant> substring. So for example you can use |
for example you can use <constant>CFG_ERR_BADOPT</constant> as a substitution |
| <constant>CFG_ERR_BADOPT</constant> as a substitution for |
for <constant>CFG_ERROR_BADOPT</constant>. |
| <constant>CFG_ERROR_BADOPT</constant>. |
|
| |
|
| </para> |
</para> |
| |
|