.\" Automatically generated by Pandoc 2.17.1.1
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "al_get_first_config_section" "3alleg5" "" "Allegro reference manual" ""
.hy
.SH NAME
.PP
al_get_first_config_section - Allegro 5 API
.SH SYNOPSIS
.IP
.nf
\f[C]
#include <allegro5/allegro.h>

char const *al_get_first_config_section(ALLEGRO_CONFIG const *config,
   ALLEGRO_CONFIG_SECTION **iterator)
\f[R]
.fi
.SH DESCRIPTION
.PP
Returns the name of the first section in the given config file.
Usually this will return an empty string for the global section, even it
contains no values.
The \f[V]iterator\f[R] parameter will receive an opaque iterator which
is used by al_get_next_config_section(3alleg5) to iterate over the
remaining sections.
.PP
The returned string and the iterator are only valid as long as no change
is made to the passed ALLEGRO_CONFIG.
.SH SEE ALSO
.PP
al_get_next_config_section(3alleg5)