واجهة برمجة تطبيقات C العامة

تتألف واجهة برمجة تطبيقات C العامة من الدوال المعرَّفة في جميع ملفات ترويسة C الموجودة في الدليل py/. ومعظم واجهات برمجة تطبيقات C الأساسية المهمة لزمن التشغيل مكشوفة في runtime.h و obj.h.

فيما يلي مثال على دوال واجهة برمجة التطبيقات العامة من 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);

في جوهرها، تشكّل أي دوال وماكروهات في ملفات الترويسة واجهة برمجة التطبيقات العامة، ويمكن استخدامها للوصول إلى تفاصيل منخفضة المستوى للغاية في MicroPython. كما أن الدوال الثابتة المُضمَّنة (static inline) في ملفات الترويسة جيدة أيضاً؛ إذ سيتم تضمين مثل هذه الدوال داخل الشيفرة عند استخدامها.

ملفات الترويسة في الدليل ports مكشوفة فقط للوظائف الخاصة بمنفذ (port) معيّن.