CXI-Basis-Programmierreferenz / Version 2 / Tools / Hilfsfunktionen /
char * cxiStringCopy (char *target, const char *source, CxiShort maxlen)
Hilfsfunktion für C++-Schnittstelle, ähnlich strncpy
target:
Zielstring
source:
Quellstring
maxlen:
Maximale Länge von target, einschließlich Nullbyte
return:
target bei Erfolg, NULL bei Fehler
Die Inline-Schnittstelle von C++ ("CXICLASS.H") verwendet diese Funktion, um Zeichenketten zu kopieren. Da die Überprüfung des Strings jedoch erst später erfolgen kann, darf bei der Kopie kein Pufferüberlauf oder sonstiger Fehler auftreten. Die folgenden Fälle werden von cxiStringCopy erkannt:
target == 0 || maxlen == 0
In beiden Fällen wird nichts kopiert und NULL zurückgeliefert.
source == 0 || strlen (source) + 1 > maxlen
Bei diesen Fehlern wird target auf "" gesetzt (d.h. *target=0) und NULL zurückgeliefert.
sonst
Der String source wird einschließlich Nullbyte nach target kopiert und der Zeiger target zurückgegeben.
Portabilität:
Diese Funktion ist in allen unterstützten Systemen verfügbar.