.TH "al_get_first_config_section(3alleg5) Allegro reference manual" "" "" "" ""
.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[]
.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.
The \f[C]iterator\f[] 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)