公開 C API¶
公開 C-API は py/
ディレクトリにあるすべての C ヘッダーファイルで定義された関数で構成されています。重要なコアランタイム C API のほとんどは runtime.h
と obj.h
で公開されています。
次にあげているものは obj.h
のパブリックAPI関数の一例です:
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);
そのコアでは、ヘッダーファイル中の関数とマクロが公開 API を構成していて、MicroPython の非常に低レベルな詳細にアクセスするために使えます。ヘッダーファイル中の静的なインライン関数も問題なく、そのような関数は使用時にコードにインライン化されます。
ports
ディレクトリにあるヘッダーファイルは、それがあるポートに固有の機能にのみ公開されます。