Python/C API Referensmanual

Denna manual dokumenterar det API som används av C- och C++-programmerare som vill skriva tilläggsmoduler eller bädda in Python. Den är en följeslagare till Utöka och bädda in Pythons tolkprogram, som beskriver de allmänna principerna för att skriva tillägg men inte dokumenterar API-funktionerna i detalj.

• Introduktion
  • Kompatibilitet med språkversioner
  • Kodningsstandarder
  • Inkludera filer
  • Användbara makron
  • Objekt, typer och referensräkningar
  • Undantag
  • Inbäddning av Python
  • Felsökning av byggnader
  • Rekommenderade verktyg från tredje part
• C API-stabilitet
  • Instabilt C API
  • Binärt gränssnitt för stabila applikationer
  • Överväganden om plattform
  • Innehåll i begränsat API
• Lagret på mycket hög nivå
• Referensräkning
• Hantering av undantag
  • Tryckning och clearing
  • Upprättande av undantag
  • Utfärdande av varningar
  • Fråga efter felindikatorn
  • Signalhantering
  • Undantagsklasser
  • Objekt för undantag
  • Objekt för Unicode-undantag
  • Kontroll av rekursion
  • Typer av undantag och varningar
• Definiera tilläggsmoduler
  • Flera modulinstanser
  • Initialiseringsfunktion
  • Initialisering i flera faser
  • Legacy enfasig initialisering
• Verktyg
  • Verktyg för operativsystem
  • Systemfunktioner
  • Processtyrning
  • Importera moduler
  • Stöd för datahantering
  • Tolkning av argument och skapande av värden
  • Konvertering och formatering av strängar
  • PyHash API
  • Reflektion
  • Kodekregister och stödfunktioner
  • PyTime C API
  • Stöd för Perf Maps
• Lager för abstrakta objekt
  • Objektprotokoll
  • Anropsprotokoll
  • Nummerprotokoll
  • Sekvensprotokoll
  • Mappningsprotokoll
  • Iteratorprotokoll
  • Buffertprotokoll
• Konkreta objektlager
  • Grundläggande objekt
  • Numeriska objekt
  • Sekvensobjekt
  • Containerobjekt
  • Funktionsobjekt
  • Övriga objekt
• Initialisering, slutförande och trådar
  • Före initialisering av Python
  • Variabler för global konfiguration
  • Initialisering och slutbehandling av tolken
  • Processövergripande parametrar
  • Thread State och det globala tolkningslåset
  • Stöd för undertolkning
  • Asynkrona notifieringar
  • Profilering och spårning
  • Referensspårning
  • Avancerat stöd för felsökare
  • Tråd Stöd för lokal lagring
  • Synkroniseringsprimitiver
• Konfiguration av Python-initialisering
  • PyInitConfig C API
  • Alternativ för konfiguration
  • Python-konfigurations-API för körtid
  • PyConfig C API
  • Py_GetArgcArgv()
  • Fördröjning av exekvering av huvudmodul
• Minneshantering
  • Översikt
  • Domäner för allokering
  • Gränssnitt för råminne
  • Minnesgränssnitt
  • Objektallokatorer
  • Standard minnesallokatorer
  • Anpassa minnesfördelare
  • Felsöknings-hooks på Pythons minnesallokatorer
  • Allokeringsverktyget pymalloc
  • Allokeringsverktyget mimalloc
  • tracemalloc C API
  • Exempel
• Stöd för implementering av objekt
  • Tilldela objekt på heapen
  • Objektets livscykel
  • Vanliga objektstrukturer
  • Typobjektstrukturer
  • Stöd för cyklisk skräpinsamling
• Versionering av API och ABI
  • Konstanter för byggtidsversion
  • Version för drifttid
  • Makron för bit-packning
• Övervakning av C API
• Generering av exekveringshändelser
  • Hantering av övervakningstillståndet