buffer insert

_BUFFER_INSERT

Type Function	INT
Input STR	STRING ( string to be copied)
POS	INT (position from which the string is copied into the buffer)
PT	POINTER TO BYTE (address of the Buffer )
SIZE	UINT (size of the buffer)
Output	INT (position in buffer post included string
The function _BUFFER_INSERT copies a string in any array of Byte and moves the rest of the array to the length of the string. The string is stored from any position POS in the buffer. The first element in the array has the position number 0. When called, a pointer to the array and its size in bytes is passed to the function. Under CoDeSys the call reads	_BUFFER_INSERT(ADR(Array), SIZEOF(Array)), where array is the name of the array to be manipulated. ADR() is a standard function which identifies the pointer to the array and SIZEOF() is a standard function, which determines the size of the array. The function returns the string copied from the buffer as STRING. The array specified by the pointer is manipulated directly in memory.
	This type of processing arrays is very efficient because no additional memory is required and no surrender values must be copied.

Example:

_BUFFER_INSERT(STR, POS, ADR(bigarray), SIZEOF(bigarray))