buffer insert

_BUFFER_INSERT

Type Funktion	INT
Input STR	STRING (zu kopierender String)
POS	INT (Position ab der der String in den Puffer kopiert wird)
PT	POINTER TO BYTE (Adresse des Puffers)
SIZE	UINT (Größe des Puffers)
Output	INT (Position in Buffer nach dem eingesetzten String)
Die Funktion _BUFFER_INSERT kopiert einen String in ein beliebiges Array of Byte und Verschiebt den Rest des Array um die Länge des Strings. Der String wird ab einer beliebigen Position POS im Puffer abgelegt. Das erste Element im Array hat die Positionsnummer 0. Beim Aufruf wird der Funktion ein Pointer auf das zu bearbeitende Array und dessen Größe in Bytes übergeben. Unter CoDeSys lautet der Aufruf	_BUFFER_INSERT(STR, POS, ADR(Array), SIZEOF(Array)), wobei Array der Name des zu manipulierenden Arrays ist. ADR ist eine Standardfunktion, die den Pointer auf das Array ermittelt und SIZEOF ist eine Standardfunktion, die die Größe des Arrays ermittelt. Die Funktion liefert die erste Position im Buffer nach dem eingesetzten String zurück. Das durch den Pointer angegebene Array wird direkt im Speicher manipuliert.
	Diese Art der Bearbeitung von Arrays ist äußerst effizient, da kein zusätzlicher Speicher benötigt wird und keine Übergabewerte kopiert werden müssen.

Beispiel:

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