al_get_cpu_count(3alleg5)

✨ NAME ✨

al_get_cpu_count — Allegro 5 API. Bestie, this is the al_get_cpu_count(3alleg5) page, and it's giving "how many CPU cores does this system actually have?" energy. 👑

🦋 SYNOPSIS 🦋

#include <allegro5/allegro.h>

int al_get_cpu_count(void)

🌸 DESCRIPTION 🌸

Okay so al_get_cpu_count returns the number of CPU cores that the system Allegro is running on has, and which could be detected. If detection failed, it returns a negative number. 💀

No cap, though: even if a positive number is returned, it might be that it is not correct. For example, Allegro running on a virtual machine will return the amount of CPU’s of the VM, and not that of the underlying system. 🫠

And even if the number is correct, this only gives you information about the total CPU cores of the system Allegro runs on. The amount of cores available to your program may be less due to circumstances such as programs that are currently running. 😭

Therefore, it’s best to use this for advisory purposes only. It is certainly a bad idea to make your program exclusive to systems for which this function returns a certain “desirable” number. That's not the vibe, bestie. 🚫

This function may be called prior to al_install_system(3alleg5) or al_init(3alleg5). Slay. ✨

⭐ SINCE ⭐

5.1.12 — been iconic since then. 👑

---

Kisses from the Allegro reference manual 💖 — this page is literally al_get_cpu_count(3alleg5). 🎀