Die öffentliche C-API

Die öffentliche C-API umfasst Funktionen, die in allen C-Header-Dateien im Verzeichnis py/ definiert sind. Die meisten der wichtigen zentralen Laufzeit-C-APIs werden in runtime.h und obj.h bereitgestellt.

Das Folgende ist ein Beispiel für Funktionen der öffentlichen API aus 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);

Im Kern bilden alle Funktionen und Makros in Header-Dateien die öffentliche API und können verwendet werden, um auf sehr systemnahe Details von MicroPython zuzugreifen. Auch statische Inline-Funktionen in Header-Dateien sind in Ordnung; solche Funktionen werden bei Verwendung in den Code eingebettet.

Header-Dateien im Verzeichnis ports werden nur für die Funktionalität bereitgestellt, die für einen bestimmten Port spezifisch ist.