Hilfe zum PBXB64-Compiler

H-Lib C API

Native C-API zum Erstellen und Bearbeiten von H-Lib-Containerobjekten aus C-Code oder Inline-Assembly.

Kategorie: H-Lib-Container | Zertifizierung: [ZERTIFIZIERT GETESTET]

Beschreibung

Native C-API zum Erstellen und Bearbeiten von H-Lib-Containerobjekten aus C-Code oder Inline-Assembly.

Typ: API-Referenz | Kategorie: Native H-Lib-Container

PBXB64-Status:VERFÜGBAR

PBXB64-Zertifizierung: [ZERTIFIZIERT GETESTET]

Überblick

Die H-Lib C-API stellt alle 23 Containerfamilien als C-Funktionen bereit. C-Aufrufer verwalten Handles explizit; BASIC-Variablen werden automatisch initialisiert und finalisiert.

Gemeinsame Funktionen

c_hlib_<variant>_new() – einen neuen Container anlegen und ein besitzendes Handle zurückgeben.
c_hlib_<variant>_final() – Containerressourcen freigeben und das Handle ungueltig machen.
c_hlib_<variant>_push, _pop, _get, _set — familiespezifische Operationen auf dem von _new() gelieferten Handle.

Aufrufvertrag

Zuerst anlegen, dann das Handle nur verwenden, solange es gueltig ist, und _final() genau einmal aufrufen, wenn der Container nicht mehr benoetigt wird. Funktionen, die Container-Handles zurückgeben, uebereignen das Eigentum an den Aufrufer. Skalar rueckgebende Funktionen uebertragen kein Eigentum. Wenn eine Methode fehlschlagen kann, pruefen Sie den Rueckgabewert, bevor Sie einen Zeiger dereferenzieren oder einen Ausgabewert verwenden.

Parameterregeln

Zeigerparameter erwarten normalerweise die Adresse eines vorhandenen PBXB64-Werts oder eines C-Puffers mit dem dokumentierten Elementtyp.
Zaehler- und Indexparameter sind pointergroessen- oder 64-Bit-Werte, wenn die Familie das verlangt; kuerzen Sie sie in neuem Code nicht auf 32 Bit.
PB-Methoden und PB-Indexzugriffe für Arr, Lst, Str, 2D und Slices sind 1-basiert. Direkte C-API-Funktionen verwenden die jeweils dokumentierte C-Indexkonvention.
Funktionen, die Strings oder Arrays zurueckgeben, liefern normalerweise einen neuen Container oder Puffer im Besitz des Aufrufers, sofern die Familienseite keine geteilte Speicherung beschreibt.

PBXB64-Prüfung

Diese Referenzseite soll durch ein fokussiertes Compile- oder Laufzeitbeispiel belegt sein. Das Beispiel soll Eingaben, erwartete Ausgabe oder Exit-Code und erforderliche Windows-Ressourcen oder Include-Dateien nennen.

Übersichtshinweise

Allgemeine Übersichtsseiten sollten trotzdem sagen, welche Familie gemeint ist, welche konkreten Befehlsseiten die Implementierung tragen und welche Formen nur der Navigation dienen. So bleibt die Seite detailliert genug, ohne so zu tun, als wäre sie eine vollständige Befehlsreferenz.

Zurück zum Befehlsindex