Sprung zum Seitenende Struktur Themen A...Z Titel << >>

CXI-Basis-Programmierreferenz / Version 2 / Tools / Hilfsfunktionen /

StringCopy - Kopie einer Zeichenkette

[C] char * cxiStringCopy (char *target, const char *source, CxiShort maxlen)

[S5:VERALTET] 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.


[i] CXI-Basis-Programmierreferenz
Version 2.10 72 (1014-001), erstellt am 15. April 2000
Textseite 85 von 855, Thema 8313 (StringCopy)
[c] Copyright (c) 1996-2000 by TeraConnect GmbH

Sprung zum Seitenanfang Struktur Themen A...Z Titel << >>