theKernel 10.0
Loading...
Searching...
No Matches
MkKernel_PrimitiveTypes_PY_API

C-API: MkKernel_PrimitiveType_C_API - MkKernel PACKAGE - a collection of all native-data-types supported by MkBufferC

+ Collaboration diagram for MkKernel_PrimitiveTypes_PY_API:

C-API: MkKernel_PrimitiveType_C_API - MkKernel PACKAGE - a collection of all native-data-types supported by MkBufferC

The data send from one package-item to an other package-item is focused on speed and usability. By default the data is send as binary, only if the endian changes or a string representation is required an additional transformation is done.
The data send from one package-item to an other package-item is limited to a collection of specific types, based on native C data types.
An pymkkernel-API command with a focus on a specific type is using a type-postfix, for example MqReadSTR read a (STR=string) data from the read-package.
In the documentation the type-item (TT) is a synonym for a (Y,O,S,I,W,F,D,B,C,L,U) type-item.

The following native-type identifier are available:

TT T native comment
BOL O bool 1 byte boolean value using True or False
I8 Y int8 1 byte signed character
I16 S int16 2 byte signed short
I32 I int32 4 byte signed integer
I64 W int64 8 byte signed long long integer
FLT F float 4 byte float
DBL D double 8 byte double
BIN B binary unsigned char array used for binary data
STR C string string data using a \0 at the end

The following composee identifier's are available:

TT T native comment
BUF U MkBufferC buffer-item that can hold any single typed item from above
BFL L MkBufferListC buffer-list that can hold many buffer-item from above

Every native-data-type is encapsualted into a MkBufferC. A MkBufferC is type safe, this mean that every read to a MkBufferC have to match the data-type of the previous write. One exception is available, the cast from and to the C data-type (TYPE=C) is allowed.

Sending data mean sending one ore more MkBufferC from one package-item to an other package-item. The sender is using a MqSendTT command to put data as MkBufferC into an send-data-package and the reveiver is using a MqReadTT command to retrieve the data from the read-data-package.