A API C pública

A API C pública compreende funções definidas em todos os ficheiros de cabeçalho C no diretório py/. A maioria das APIs C mais importantes do núcleo de execução estão expostas em runtime.h e obj.h.

A seguir encontra-se um exemplo de funções da API pública 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);

No seu núcleo, quaisquer funções e macros em ficheiros de cabeçalho constituem a API pública e podem ser usadas para aceder a detalhes de muito baixo nível do MicroPython. Funções inline estáticas em ficheiros de cabeçalho também são válidas; essas funções serão incorporadas no código quando utilizadas.

Os ficheiros de cabeçalho no diretório ports são apenas expostos à funcionalidade específica de um determinado port.