KlassenKlassenKlassenKlassen | | | | Operatoren

obj_to_integerobj_to_integerObjToIntegerobj_to_integerObjToIntegerObjToInteger (Operator)

Name

obj_to_integerobj_to_integerObjToIntegerobj_to_integerObjToIntegerObjToInteger — Konversion von Surrogaten (Bildobjekten) zu „ganzen Zahlen“.

Signatur

obj_to_integer(Objects : : Index, Number : SurrogateTuple)

Herror obj_to_integer(const Hobject Objects, const Hlong Index, const Hlong Number, Hlong* SurrogateTuple)

Herror T_obj_to_integer(const Hobject Objects, const Htuple Index, const Htuple Number, Htuple* SurrogateTuple)

Herror obj_to_integer(Hobject Objects, const HTuple& Index, const HTuple& Number, Hlong* SurrogateTuple)

Herror obj_to_integer(Hobject Objects, const HTuple& Index, const HTuple& Number, HTuple* SurrogateTuple)

void ObjToInteger(const HObject& Objects, const HTuple& Index, const HTuple& Number, HTuple* SurrogateTuple)

HTuple HObject::ObjToInteger(Hlong Index, Hlong Number) const

void HOperatorSetX.ObjToInteger(
[in] IHUntypedObjectX* Objects, [in] VARIANT Index, [in] VARIANT Number, [out] VARIANT* SurrogateTuple)

VARIANT HImageX.ObjToInteger(
[in] Hlong Index, [in] Hlong Number)

VARIANT HRegionX.ObjToInteger(
[in] Hlong Index, [in] Hlong Number)

VARIANT HUntypedObjectX.ObjToInteger(
[in] Hlong Index, [in] Hlong Number)

VARIANT HXLDContX.ObjToInteger(
[in] Hlong Index, [in] Hlong Number)

VARIANT HXLDPolyX.ObjToInteger(
[in] Hlong Index, [in] Hlong Number)

VARIANT HXLDParaX.ObjToInteger(
[in] Hlong Index, [in] Hlong Number)

VARIANT HXLDModParaX.ObjToInteger(
[in] Hlong Index, [in] Hlong Number)

VARIANT HXLDExtParaX.ObjToInteger(
[in] Hlong Index, [in] Hlong Number)

static void HOperatorSet.ObjToInteger(HObject objects, HTuple index, HTuple number, out HTuple surrogateTuple)

HTuple HObject.ObjToInteger(int index, int number)

Beschreibung

obj_to_integerobj_to_integerObjToIntegerobj_to_integerObjToIntegerObjToInteger speichert ab der angegebenen Stelle (IndexIndexIndexIndexIndexindex) die gewünschte Anzahl von Surrogaten der Objekte (Objektschlüssel) aus ObjectsObjectsObjectsObjectsObjectsobjects als Integer-Werte im Ausgabeparameter SurrogateTupleSurrogateTupleSurrogateTupleSurrogateTupleSurrogateTuplesurrogateTuple. Wird für NumberNumberNumberNumberNumbernumber der Wert -1 verwendet, dann werden alle Objekte ab IndexIndexIndexIndexIndexindex kopiert. Damit wird ein Direktzugriff auf ein beliebiges Element von ObjectsObjectsObjectsObjectsObjectsobjects möglich. Im Zusammenhang mit count_objcount_objCountObjcount_objCountObjCountObj (liefert die Anzahl der in ObjectsObjectsObjectsObjectsObjectsobjects enthaltenen Objekte) kann man so eine sukzessive Abarbeitung der einzelnen Objekte in ObjectsObjectsObjectsObjectsObjectsobjects durchführen. Die Objekte werden von obj_to_integerobj_to_integerObjToIntegerobj_to_integerObjToIntegerObjToInteger nicht dupliziert und dürfen deshalb nicht gelöscht (clear_objclear_objClearObjclear_objClearObjClearObj) werden.

Achtung

Die Daten der Objekte werden nicht dupliziert.

Parallelisierung

Parameter

ObjectsObjectsObjectsObjectsObjectsobjects (input_object)  object(-array) objectHObjectHObjectHObjectHObjectXHobject

Objekte, deren Surrogate ausgegeben werden.

IndexIndexIndexIndexIndexindex (input_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Ab diesem Element werden die Surrogate der Objekte ausgegeben.

Defaultwert: 1

Typischer Wertebereich: 1 ≤ Index Index Index Index Index index

NumberNumberNumberNumberNumbernumber (input_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Anzahl der zu übergebenden Surrogate.

Defaultwert: -1

Restriktion: Number == -1 || Number + Index <= number(Objects)

SurrogateTupleSurrogateTupleSurrogateTupleSurrogateTupleSurrogateTuplesurrogateTuple (output_control)  pointer(-array) HTupleHTupleHTupleVARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Tupel der Surrogate

Beispiel (HDevelop)

* Access the i-th element:
obj_to_integer(Objects,i,1,Surrogat)

Beispiel (C)

/* Access the i-th element: */
Hlong i,Surrogate;
obj_to_integer(Objects,i,1,&Surrogat);

Beispiel (HDevelop)

* Access the i-th element:
obj_to_integer(Objects,i,1,Surrogat)

Beispiel (HDevelop)

* Access the i-th element:
obj_to_integer(Objects,i,1,Surrogat)

Beispiel (HDevelop)

* Access the i-th element:
obj_to_integer(Objects,i,1,Surrogat)

Beispiel (HDevelop)

* Access the i-th element:
obj_to_integer(Objects,i,1,Surrogat)

Komplexität

Laufzeitkomplexität: O(|ObjectsObjectsObjectsObjectsObjectsobjects| + NumberNumberNumberNumberNumbernumber)

Ergebnis

obj_to_integerobj_to_integerObjToIntegerobj_to_integerObjToIntegerObjToInteger liefert den Wert 2 (H_MSG_TRUE), falls die Parameterwerte korrekt sind. Das Verhalten bei leerer Eingabe (keine Eingabeobjekte vorhanden) lässt sich mittels set_system(::'no_object_result',<Result>:)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Alternativen

copy_objcopy_objCopyObjcopy_objCopyObjCopyObj, select_objselect_objSelectObjselect_objSelectObjSelectObj, copy_imagecopy_imageCopyImagecopy_imageCopyImageCopyImage, gen_image_protogen_image_protoGenImageProtogen_image_protoGenImageProtoGenImageProto

Siehe auch

integer_to_objinteger_to_objIntegerToObjinteger_to_objIntegerToObjIntegerToObj, count_objcount_objCountObjcount_objCountObjCountObj

Modul

Foundation


KlassenKlassenKlassenKlassen | | | | Operatoren