Artifact [88b5fcafb9]

Artifact 88b5fcafb90c9d9b53ad4a9b0d0868928e2106fd:

Wiki page [Manual for lc_geterrno] by rkeene on 2014-11-24 20:11:48.
D 2014-11-24T20:11:48.850
L Manual\sfor\slc_geterrno
P 06f6cf40866be37230cf356a8771e57320b6a5fc
U rkeene
W 3368
<H2>NAME</H2>
lc_geterrno - Retrieve a numeric error code.
<P>
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>#include &lt;<A HREF="artifact/7c61a9805e664fde7943807af8d5e164e7cebdb6">libconfig.h</A>&gt;</B>
<P>
<B>lc_err_t lc_geterrno(void);</B>
<P>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
The
<B><A HREF="wiki/Manual for lc_geterrno">lc_geterrno</A></B>(3)
function returns the last numeric error code set as an
<I>lc_err_t</I>
which is an enumerated type and can be cast to any integer type.
<P>
The
<I>lc_err_t</I>
type specifies the following defined values:
<DL COMPACT>
<DT>LC_ERR_NONE<DD>
No error was found.  Success.
<DT>LC_ERR_INVCMD<DD>
A command was specified for which there was no handler.
<DT>LC_ERR_INVSECTION<DD>
A section was specified for which there was no handler.
<DT>LC_ERR_INVDATA<DD>
A value that does not make sense was specified, such as a non-existant type to the
<B><A HREF="wiki/Manual for lc_process_file">lc_process_file</A></B>(3)
function.
<DT>LC_ERR_BADFORMAT<DD>
An invalid format was detected, such as no argument where on was expected, or a value passed to a boolean-specified variable whose value was not one of: enable, true, yes, on, y, 1, disable, false, off, no, n, 0.
<DT>LC_ERR_CANTOPEN<DD>
Unable to open a specified file.
<DT>LC_ERR_CALLBACK<DD>
A callback function returned an error (LC_CBRET_ERROR).
<DT>LC_ERR_ENOMEM<DD>
Memory could not be allocated for internal structures.
<P>
</DL>
<A NAME="lbAE">&nbsp;</A>
<H2>EXAMPLE</H2>
<PRE>
#include &lt;<A HREF="artifact/7c61a9805e664fde7943807af8d5e164e7cebdb6">libconfig.h</A>&gt;
#include &lt;<A HREF="file:/usr/include/stdlib.h">stdlib.h</A>&gt;
#include &lt;<A HREF="file:/usr/include/stdio.h">stdio.h</A>&gt;
int main(int argc, char **argv) {
        int lc_p_ret, lc_rv_ret;
        char *filename = NULL;
        lc_rv_ret = lc_register_var(&quot;File&quot;, LC_VAR_STRING,
                                    &amp;filename, 'f');
        if (lc_rv_ret != 0) {
                fprintf(stderr, &quot;Error registering variable: %i.\n&quot;,
                        lc_geterrno());
                return(EXIT_FAILURE);
        }
        lc_p_ret = lc_process(argc, argv, &quot;example&quot;, LC_CONF_APACHE,
                              NULL);
        lc_cleanup();
        if (lc_p_ret != 0) {
                fprintf(stderr, &quot;Error processing configuration: \
                        %s\n&quot;, lc_geterrstr());
                return(EXIT_FAILURE);
        }
        if (filename != NULL) {
                printf(&quot;File specified was: %s\n&quot;, filename);
        } else {
                printf(&quot;No filename specified.\n&quot;);
        }
        return(EXIT_SUCCESS);
}
</PRE>
<P>
<A NAME="lbAF">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="wiki/Manual">libconfig</A></B>(3),
<B><A HREF="wiki/Manual for lc_register_var">lc_register_var</A></B>(3),
<B><A HREF="wiki/Manual for lc_register_callback">lc_register_callback</A></B>(3),
<B><A HREF="wiki/Manual for lc_geterrstr">lc_geterrstr</A></B>(3),
<B><A HREF="wiki/Manual for lc_seterrstr">lc_seterrstr</A></B>(3),
<B><A HREF="wiki/Manual for lc_handle_type">lc_handle_type</A></B>(3),
<B><A HREF="wiki/Manual for lc_process">lc_process</A></B>(3),
<B><A HREF="wiki/Manual for lc_process_file">lc_process_file</A></B>(3),
<B><A HREF="wiki/Manual for lc_cleanup">lc_cleanup</A></B>(3)
<P>

Z 3fed2a00d8bf7e6bd4601994d5005688