AL_GET_FIRST_CONFIG_SECTION(3)

💅 AL_GET_FIRST_CONFIG_SECTION(3) 💅

okay bestie, welcome to the Library Functions Manual — this is the Allegro 5 API page for al_get_first_config_section, and it's literally the “start at the top of the config sections” girlie. 🎀

🌸 NAME 🌸

al_get_first_config_section — Allegro 5 API

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

char const *al_get_first_config_section(ALLEGRO_CONFIG const *config,
   ALLEGRO_CONFIG_SECTION **iterator)

🦋 DESCRIPTION 🦋

So this one returns the name of the first section in the given config file. Usually it'll hand you back an empty string for the global section, even if it contains no values. No drama, that's just the vibe. 💖

The iterator parameter will receive an opaque iterator, and that little icon is used by al_get_next_config_section(3) to iterate over the remaining sections. iykyk. ✨

⚠️ okay important bestie: the returned string and the iterator are only valid as long as no change is made to the passed ALLEGRO_CONFIG. Do not be out here mutating it and then expecting those pointers to slay. 💀

🌈 SEE ALSO 🌈

• al_get_next_config_section(3)

---

mwah 💋 — this one is signed off by the Allegro reference manual, which is the source/version line, and there's no date listed in the footer, so that's the whole cute sign-off, fr fr. 🫶💖