al_get_cpu_count(3) al_get_cpu_count(3)

al_get_cpu_count - Allegro 5 API

#include <allegro5/allegro.h>
int al_get_cpu_count(void)

Returns the number of CPU cores that the system Allegro is running on has and which could be detected, or a negative number if detection failed. 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.

Furthermore 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.

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


Allegro reference manual