Hilfe zum PBXB64-Compiler

H-Lib-Container-Funktionsparameter

Parameterkonventionen, die von H-Lib-Containermethoden und C-API-Funktionen verwendet werden.

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

Beschreibung

Parameterkonventionen, die von H-Lib-Containermethoden und C-API-Funktionen verwendet werden.

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

PBXB64-Status:VERFÜGBAR

PBXB64-Zertifizierung: [ZERTIFIZIERT GETESTET]

Parametertypen

Schlüsselparameter: Der Typ hängt von der Containerfamilie ab. Hash-Tabellen, Bäume und Tries verwenden typischerweise Zeichenfolgen oder UDT-kompatible Schlüssel; mengenartige Familien verwenden ganze Zahlen.
Wertparameter: typischerweise INT64, Zeigergröße oder ein per Referenz übergebenes Payload, das zum Elementtyp passt.
PB-Indexparameter: 1-basierte Ganzzahlen für Arr, Lst, Str, 2D und Slices.
Flags: Bitmaskenoptionen, die Einfüge-, Such-, Vergleichs- oder Traversalverhalten steuern.

String-Argumente

Übergeben Sie für Container mit Zeichenfolgenschlüssel ein const char* aus C oder einen PB STRING-Ausdruck aus BASIC. Der String muss fuer die Dauer des Aufrufs gueltig bleiben; wenn die Familie den Schlüssel intern kopiert, soll die jeweilige Familienseite das explizit sagen.

Eigentumsregeln

Methoden, die einen Container anlegen oder zurückgeben, übertragen das Eigentum an den Aufrufer. Methoden, die nur einen Wert lesen, übertragen kein Eigentum. Methoden, die einen Zeiger in den Containerspeicher zurückgeben, liefern nur eine kurzfristige Sicht; dieser Zeiger wird nach der naechsten Aenderung, dem Loeschen oder der Freigabe ungueltig, sofern die Familienseite nichts anderes sagt.

Rückgabewerte

Die zählenden Add/Push-Operationen von Arr, Stk, Que und Lst geben deterministisch die neue Anzahl zurück. Bei Strings geben Append und AppendLine die neue Länge zurück; Replace gibt die Anzahl der Ersetzungen zurück. TryGet liefert den gespeicherten Wert oder den übergebenen Standardwert. Remove gibt nur dann einen Wert ungleich Null zurück, wenn ein Schlüssel entfernt wurde.

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