API C công khai

API C công khai bao gồm các hàm được định nghĩa trong tất cả các tệp tiêu đề C trong thư mục py/. Hầu hết các API C quan trọng của runtime cốt lõi đều được hiển thị trong runtime.hobj.h.

Sau đây là ví dụ về các hàm API công khai từ 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);

Về cơ bản, bất kỳ hàm và macro nào trong các tệp tiêu đề đều tạo nên API công khai và có thể được sử dụng để truy cập các chi tiết cấp rất thấp của MicroPython. Các hàm nội tuyến tĩnh (static inline) trong tệp tiêu đề cũng được chấp nhận; các hàm như vậy sẽ được nội tuyến hóa vào mã khi sử dụng.

Các tệp tiêu đề trong thư mục ports chỉ được hiển thị cho các tính năng đặc thù của một cổng (port) nhất định.