6.8.64 DMcob_ValueInit
Mit dieser Funktion kann ein Wert in eine vom IDM gemanagte lokale oder globale Wertereferenz umgewandelt werden. Dadurch ist die weitere Manipulation des Wertes durch DMcob_Value*-Funktionen möglich sowie die Rückgabe als Parameter bzw. Rückgabewert.
Die Wertereferenz wird mit dem entsprechenden Typ initialisiert. Erlaubt sind auch die Sammlungsdatentypen DT-list, DT-vector, DT-hash, DT-matrix und DT-refvec.
Wird die Wertereferenz über die Option DMF-StaticValue als statisch bzw. global initialisiert, so ist ein Zugriff auch außerhalb des Funktionsaufrufs möglich. Eine Freigabe von Wertelisten und Strings findet beim Funktionsende nicht statt. Nicht erlaubt ist die Initialisierung von Argumenten zu einer statischen bzw. globalen gemanagten Wertereferenz.
Sammlungen werden ohne Elementwerte angelegt. Auch alle anderen Wertetypen werden zu einem 0-Wert initialisiert.
Das Hinzufügen oder Ändern von Werten oder Teilwerten bzw. Elementen kann über die Funktion DMcob_ValueChange geschehen.
77 AnyValue pointer value null.
77 Type pic 9(4) binary value 0.
call "DMcob_ValueInit" using
DM-StdArgs
AnyValue
Type
DM-Value.
Parameter
<-> DM-options of DM-StdArgs
|
Option |
Bedeutung |
|---|---|
|
0 |
Wertereferenz wird als lokaler Wert initialisiert. |
|
Wertereferenz wird als globaler, statischer Wert initialisiert. |
<- AnyValue
Handle des neu angelegten verwalteten Wertes.
-> Type
Dieser Parameter bezeichnet den geforderten initialen Typ.
-> DM-indexcount of DM-Value
In diesem Parameter kann die initiale Größe von Sammlungen wie list oder matrix angegeben werden oder der zugehörige Wertetyp bei vector-Werten.
Rückgabewert
DM-status of DM-StdArgs
|
DM-error |
Wertereferenz konnte nicht initialisiert werden. |
|
DM-success |
Funktion konnte erfolgreich ausgeführt werden, die Wertereferenz ist damit initialisiert. |
Verfügbarkeit
Nur COBOL-Schnittstelle für Micro Focus Visual COBOL.
Siehe auch
Support