GLOBAL char *um_strcpy(char *dest, const char *src, size_t max, const char *place);
um_strcpy kopiert den String src in den String dest, wenn der String dest die Laenge von max nicht uebersteigt (auf das Nullbyte wird geachtet). max gibt die Groesse in Byte an, die dest aufnehmen kann.
Gilt folgende Deklaration:
char test[1000]
so kann um_strcpy wie folgt aufgerufen werden:
um_strcpy(test, "Hallo Welt!", 1000, "Meine Funktion");
Der Parameter place gibt hierbei an, in welcher Methode die um_strcpy Funktion steht. Hierraus kann man beim Debuggen bzw. bei der Fehlermeldung erkennen, welcher Puffer zu klein gewaehlt wurde. place sollte im ganzen UDO-Projekt eindeutig gewaehlt werden, man kann z.B. auch den Funktionsnamen und das n-te Vorkommen ausdruecken: "copy_token[5]".