Python/C API reference manual
*****************************

이 설명서는 확장 모듈을 작성하거나 파이썬을 내장하고자 하는 C와 C++ 프
로그래머가 사용하는 API에 관해 설명합니다. 이 설명서와 쌍을 이루는 파
이썬 인터프리터 확장 및 내장 는 확장 제작의 일반 원칙을 설명하지만,
API 함수를 자세하게 설명하지는 않습니다.

* 소개

  * Language version compatibility

  * 코딩 표준

  * 인클루드 파일

  * 유용한 매크로들

  * 객체, 형 그리고 참조 횟수

  * 예외

  * 파이썬 임베딩하기

  * 디버깅 빌드

  * Recommended third party tools

* C API Stability

  * Unstable C API

  * 안정적인 응용 프로그램 바이너리 인터페이스

  * Platform Considerations

  * Contents of Limited API

* 매우 고수준 계층

  * Available start symbols

  * Stack Effects

* 참조 횟수

* 예외 처리

  * 인쇄와 지우기

  * 예외 발생시키기

  * 경고 발행하기

  * 에러 표시기 조회하기

  * 시그널 처리하기

  * 예외 클래스

  * 예외 객체

  * 유니코드 예외 객체

  * 재귀 제어

  * Exception and warning types

  * Tracebacks

* Defining extension modules

  * Multiple module instances

  * Initialization function

  * Multi-phase initialization

  * Legacy single-phase initialization

* 유틸리티

  * 운영 체제 유틸리티

  * 시스템 함수

  * 프로세스 제어

  * 모듈 임포트 하기

  * 데이터 마샬링 지원

  * 인자 구문 분석과 값 구축

  * 문자열 변환과 포매팅

  * Character classification and conversion

  * PyHash API

  * 리플렉션

  * 코덱 등록소와 지원 함수

  * PyTime C API

  * Support for Perf Maps

* 추상 객체 계층

  * 객체 프로토콜

  * 호출 프로토콜

  * 숫자 프로토콜

  * 시퀀스 프로토콜

  * 매핑 프로토콜

  * 이터레이터 프로토콜

  * 버퍼 프로토콜

* 구상 객체 계층

  * 기본 객체

  * 숫자 객체

  * 시퀀스 객체

  * 컨테이너 객체

  * 함수 객체

  * 기타 객체

  * C API for extension modules

* Interpreter initialization and finalization

  * Before Python initialization

  * Global configuration variables

  * Initializing and finalizing the interpreter

  * Cautions regarding runtime finalization

  * Process-wide parameters

* Thread states and the global interpreter lock

  * Detaching the thread state from extension code

  * Non-Python created threads

  * Legacy API

  * Cautions about fork()

  * High-level APIs

  * GIL-state APIs

  * Low-level APIs

* Asynchronous notifications

* Operating system thread APIs

* Synchronization primitives

  * Python critical section API

  * Legacy locking APIs

* Thread-local storage support

  * Thread-specific storage API

  * Dynamic allocation

  * Methods

  * Legacy APIs

* Multiple interpreters in a Python process

  * A per-interpreter GIL

  * Bugs and caveats

  * High-level APIs

  * Low-level APIs

  * Advanced debugger support

* Profiling and tracing

* Reference tracing

* 파이썬 초기화 구성

  * PyInitConfig C API

  * Configuration Options

  * Runtime Python configuration API

  * PyConfig C API

  * Py_GetArgcArgv()

  * Delaying main module execution

* 메모리 관리

  * 개요

  * Allocator Domains

  * 원시 메모리 인터페이스

  * 메모리 인터페이스

  * 객체 할당자

  * 기본 메모리 할당자

  * 메모리 할당자 사용자 정의

  * 파이썬 메모리 할당자의 디버그 훅

  * pymalloc 할당자

  * mimalloc 할당자

  * tracemalloc C API

  * 예

* 객체 구현 지원

  * 힙에 객체 할당하기

  * Object Life Cycle

  * 공통 객체 구조체

  * Type Object Structures

  * 순환 가비지 수집 지원

* API와 ABI 버전 붙이기

  * Build-time version constants

  * Run-time version

  * Bit-packing macros

* Monitoring C API

* Generating Execution Events

  * Managing the Monitoring State
