Hilfe zum PBXB64-Compiler

H-Lib-Subscript-Zugriff

So lesen und schreiben Sie H-Lib-Containerelemente mithilfe der Indexsyntax.

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

Syntax

value = container(index)
container(index) = value
value = container(key)
container(key) = value

Beschreibung

So lesen und schreiben Sie H-Lib-Containerelemente mithilfe der Indexsyntax.

Typ: automatisch durchsucht. Referenz | Kategorie: Native H-Lib-Container

PBXB64-Status:VERFÜGBAR

PBXB64-Zertifizierung: [ZERTIFIZIERT GETESTET]

Regeln

PB-Positionen in Arr, Lst, Str, 2D und Slices sind 1-basiert.
Schluesselbasierte Container verwenden den Schlüsseltyp der Familie, typischerweise Zeichenfolgen oder numerische Schlüssel.
Ein Lesezugriff auf einen fehlenden Schlüssel ist ein familiespezifischer "nicht gefunden"-Fall und kein allgemeiner Compilerfehler.
Ein Schreibzugriff kann je nach Familie ein neues Element einfügen, ein vorhandenes aktualisieren oder den Container erweitern.

Verwendungshinweise

Verwenden Sie die Indexsyntax, wenn der Compiler bei einem Lesen oder Schreiben an genau einer Position oder unter genau einem Schlüssel den passenden Containeraufruf erzeugen soll. Verwenden Sie die Methodenseiten, wenn Sie die Erstellung, Traversierung oder Freigabe des Container-Handles explizit steuern wollen.

Array-Prüfung

Array-Referenzseiten sollen Grenzen, Dimensionen, Elementtyp, Allokationszustand und die Frage dokumentieren, ob die Operation den Array-Deskriptor ändert. Ein vollständiges Beispiel deckt ein leeres Array, ein gefülltes Array und mindestens einen Grenzindex ab.

PBXB64-x64-Hinweise

Beim Portieren älteren Codes sind zeigergroße Deskriptoren und API-Aufrufe zu prüfen, die Array-Speicher erhalten. Bevorzugen Sie explizite Unter- und Obergrenzen und geben Sie einen klaren Fehlercode zurück, wenn Index- oder Dimensionsannahmen verletzt werden.

Beispiel

FUNCTION PBMAIN() AS LONG
  LOCAL arr AS LNARR OF LONG
  arr(1) = 10
  PRINT arr(1)
  FUNCTION = 0
END FUNCTION