HALCON Website / HALCON Operator-Referenz / System / Serialisiertes Element
KlassenKlassenKlassenKlassen | | | | Operatoren

create_serialized_item_ptrcreate_serialized_item_ptrCreateSerializedItemPtrcreate_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtr (Operator)

Name

create_serialized_item_ptrcreate_serialized_item_ptrCreateSerializedItemPtrcreate_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtr — Anlegen eines serialisierten Elements.

Warnung

Es wird nicht empfolen, den Operator create_serialized_item_ptrcreate_serialized_item_ptrCreateSerializedItemPtrcreate_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtr in HDevelop zu verwenden.

Signatur

create_serialized_item_ptr( : : Pointer, Size, Copy : SerializedItemHandle)

Herror create_serialized_item_ptr(const Hlong Pointer, const Hlong Size, const char* Copy, Hlong* SerializedItemHandle)

Herror T_create_serialized_item_ptr(const Htuple Pointer, const Htuple Size, const Htuple Copy, Htuple* SerializedItemHandle)

Herror create_serialized_item_ptr(const HTuple& Pointer, const HTuple& Size, const HTuple& Copy, Hlong* SerializedItemHandle)

void HSerializedItem::CreateSerializedItemPtr(const HTuple& Pointer, const HTuple& Size, const HTuple& Copy)

void CreateSerializedItemPtr(const HTuple& Pointer, const HTuple& Size, const HTuple& Copy, HTuple* SerializedItemHandle)

void HSerializedItem::HSerializedItem(void* Pointer, Hlong Size, const HString& Copy)

void HSerializedItem::HSerializedItem(void* Pointer, Hlong Size, const char* Copy)

void HSerializedItem::CreateSerializedItemPtr(void* Pointer, Hlong Size, const HString& Copy)

void HSerializedItem::CreateSerializedItemPtr(void* Pointer, Hlong Size, const char* Copy)

void HOperatorSetX.CreateSerializedItemPtr(
[in] VARIANT Pointer, [in] VARIANT Size, [in] VARIANT Copy, [out] VARIANT* SerializedItemHandle)

void HSerializedItemX.CreateSerializedItemPtr(
[in] Hlong Pointer, [in] Hlong Size, [in] BSTR Copy)

static void HOperatorSet.CreateSerializedItemPtr(HTuple pointer, HTuple size, HTuple copy, out HTuple serializedItemHandle)

public HSerializedItem(IntPtr pointer, int size, string copy)

void HSerializedItem.CreateSerializedItemPtr(IntPtr pointer, int size, string copy)

Beschreibung

create_serialized_item_ptrcreate_serialized_item_ptrCreateSerializedItemPtrcreate_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtr legt ein serialisiertes Element an, und gibt dessen Handle SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle zurück (siehe fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItem für eine Einführung in die Grundlagen der Serialisierung). Mit dem Parameter PointerPointerPointerPointerPointerpointer wird der Datenzeiger, d.h. der Anfang des serialisierten Elements, übergeben. Mit dem Parameter SizeSizeSizeSizeSizesize wird die Größe des serialisierten Elements in Byte übergeben. Mit dem Parameter CopyCopyCopyCopyCopycopy wird das Verhalten des Operators gesteuert. Falls CopyCopyCopyCopyCopycopy auf den Wert 'true'"true""true""true""true""true" gesetzt ist, wird ein neues serialisiertes Element erzeugt und die Werte des vorhandenen serialisierten Elements kopiert. Falls CopyCopyCopyCopyCopycopy auf den Wert 'false'"false""false""false""false""false" gesetzt ist, wird nur der Datenzeiger des übergebenen serialisierten Elements gespeichert ohne die Daten in ein neues serialisiertes Element zu kopieren. In diesem Fall erhöht sich die Geschwindigkeit des Operators.

Achtung

Falls der Parameter CopyCopyCopyCopyCopycopy auf den Wert 'false'"false""false""false""false""false" gesetzt ist, darf der zum Datenzeiger des serialisierten Elements gehörende Speicher während der Nutzung des neuen serialisierten Elements nicht gelöscht werden.

Parallelisierung

Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.

Parameter

PointerPointerPointerPointerPointerpointer (input_control)  pointer → HTupleHTupleHTupleVARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Datenzeiger auf ein serialisiertes Element.

SizeSizeSizeSizeSizesize (input_control)  integer → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Größe des serialisierten Elements.

CopyCopyCopyCopyCopycopy (input_control)  string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Kopiermodus des serialisierten Elements.

Defaultwert: 'true' "true" "true" "true" "true" "true"

Werteliste: 'false'"false""false""false""false""false", 'true'"true""true""true""true""true"

SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle (output_control)  serialized_item → HSerializedItem, HTupleHTupleHSerializedItem, HTupleHSerializedItemX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle des serialisierten Elements.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert create_serialized_item_ptrcreate_serialized_item_ptrCreateSerializedItemPtrcreate_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtr den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Nachfolger

get_serialized_item_ptrget_serialized_item_ptrGetSerializedItemPtrget_serialized_item_ptrGetSerializedItemPtrGetSerializedItemPtr

Modul

Foundation

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 12.0.2 Copyright © 1996-2016 MVTec Software GmbH