combit List & Label - Programmierer-Referenz - combit GmbH

Hinweise zu den Parametern
C: 0x1a2b3c4d
Delphi: $1a2b3c4d
Visual Basic: &H1a2b3c4d
Gelegentlich kommen auch Zeichen vor wie ´\xaa´. Das ist die C/C++-Schreibweise für
ein Zeichen mit dem Hexadezimalcode aa, also 170 dezimal. In Delphi ist das chr($aa), in
Visual Basic chr$(&Haa).
8.2. Hinweise zu den Parametern
� Zeichenketten sind alle Null-terminiert zu übergeben.
� Beachten Sie bei C oder C++ die C-Konvention, dass Sie in Quelltexten für '\' ,
z.B. in Pfadangaben, dieses doppelt eingeben müssen: "c:\\temp.lbl" statt
"c:\temp.lbl".
� Bei Puffern muss die dem übergebenen Längenparameter entsprechende Anzahl
an Bytes (Unicode-API: in Zeichen) reserviert sein, ansonsten lässt sich wie immer
ein ´Unbehebbarer Anwendungsfehler´ nicht vermeiden, oder das Programm
läuft nicht korrekt, oder es werden zu wenig Zeichen kopiert. Achten Sie
auf den Fehlercode LL_ERR_BUFFERTOOSMALL.
� Die Parameter werden soweit möglich, auf Korrektheit überprüft. Während der
Programmentwicklung lohnt es sich also, den Debug-Modus einzuschalten (siehe
LlSetDebug()) und die Rückgabewerte zu überprüfen. Später können Sie dann die
Parameterüberprüfung explizit ausschalten (LL_OPTION_NOPARAMETERCHECK).
8.3. Allgemeines zum Rückgabewert
� Null (oder bei manchen Funktionen positive Rückgabewerte) bedeutet im allgemeinen,
dass die Funktion erfolgreich war.
� Ein negativer Rückgabewert signalisiert bis auf Ausnahmefälle einen Fehler, der
über die entsprechenden Fehlerkonstanten den Grund bezeichnet.
8.4. Variablen/Felder und deren Werte
Die unten angegebenen Hinweise gelten sowohl für Variablen wie auch für Felder, bei
letzteren muss man also "Variable" einfach sinngemäß durch "Feld" ersetzen.
8.4.1. Im Variablennamen verwendbare Zeichen
Im Variablennamen dürfen nur alphanumerische Zeichen, also 'a'..'z', 'A'..'Z', '0'..'9', '.' und
'_' sowie Umlaute verwendet werden. Zahlen dürfen nicht an erster Stelle stehen. Alle
nicht-erlaubten Zeichen werden zu einem Unterstrich ('_') umgesetzt. Der Punkt ist ein
Hierarchietrenner für die Variablenhierarchie.
125