L’API C pubblica

L’API C pubblica comprende le funzioni definite in tutti i file header C nella directory py/. La maggior parte delle importanti API C del runtime principale è esposta in runtime.h e obj.h.

Di seguito un esempio di funzioni dell’API pubblica da 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);

Fondamentalmente, qualsiasi funzione e macro nei file header costituisce l’API pubblica e può essere utilizzata per accedere a dettagli di bassissimo livello di MicroPython. Anche le funzioni static inline nei file header vanno bene; tali funzioni saranno inline nel codice quando vengono utilizzate.

I file header nella directory ports sono esposti solo alle funzionalità specifiche di un determinato port.