L’API C publique

L’API C publique comprend les fonctions définies dans tous les fichiers d’en-tête C du répertoire py/. La plupart des API C importantes du moteur d’exécution principal sont exposées dans runtime.h et obj.h.

Voici un exemple de fonctions de l’API publique issues de obj.h :

mp_obj_t mp_obj_new_list(size_t n, mp_obj_t *items);
mp_obj_t mp_obj_list_append(mp_obj_t self_in, mp_obj_t arg);
mp_obj_t mp_obj_list_remove(mp_obj_t self_in, mp_obj_t value);
void mp_obj_list_get(mp_obj_t self_in, size_t *len, mp_obj_t **items);

Fondamentalement, toutes les fonctions et macros des fichiers d’en-tête constituent l’API publique et peuvent être utilisées pour accéder à des détails de très bas niveau de MicroPython. Les fonctions static inline des fichiers d’en-tête conviennent aussi ; de telles fonctions seront intégrées (inlined) dans le code lors de leur utilisation.

Les fichiers d’en-tête du répertoire ports ne sont exposés qu’à la fonctionnalité propre à un port donné.