wcscat, wcscat_s

wchar_t* wcscat( wchar_t* dest, const wchar_t* src );

wchar_t* wcscat( wchar_t* restrict dest, const wchar_t* restrict src );

errno_t wcscat_s( wchar_t* restrict dest, rsize_t destsz,
                  const wchar_t* restrict src );

1) Hängt eine Kopie der Breitzeichenkette, auf die src zeigt, an das Ende der Breitzeichenkette, auf die dest zeigt, an. Das Breitzeichen src[0] ersetzt den Nullterminator am Ende von dest. Die resultierende Breitzeichenkette wird nullterminiert. Das Verhalten ist undefiniert, wenn das Ziel-Array nicht groß genug für den Inhalt von src und dest sowie des abschließenden Null-Breitzeichens ist. Das Verhalten ist undefiniert, wenn sich die Zeichenketten überschneiden.

2) Gleicht (1), außer dass es den Rest des Ziel-Arrays (ab dem zuletzt geschriebenen Zeichen bis destsz) mit nicht spezifizierten Werten überschreiben kann und dass die folgenden Fehler zur Laufzeit erkannt werden und die derzeit installierte Constraint-Handler-Funktion aufrufen:

• src oder dest ist ein Nullpointer
• destsz ist null oder größer als RSIZE_MAX / sizeof(wchar_t)
• es gibt keinen Nullterminator in den ersten destsz Breitzeichen von dest
• Abschneiden würde auftreten (der verfügbare Platz am Ende von dest würde nicht jedes Breitzeichen, einschließlich des Nullterminators, von src fassen)
• Überschneidung würde zwischen Quell- und Ziel-Strings auftreten

Wie bei allen grenzgeprüften Funktionen ist wcscat_s nur dann garantiert verfügbar, wenn __STDC_LIB_EXT1__ durch die Implementierung definiert ist und der Benutzer __STDC_WANT_LIB_EXT1__ auf die ganzzahlige Konstante 1 setzt, bevor er <wchar.h> einbindet.

1) gibt eine Kopie von dest

zurück2)L'\0' gibt bei Erfolg Null zurück, bei Fehler einen von Null verschiedenen Wert. Außerdem wird bei Fehler dest[0] in dest geschrieben (es sei denn, destsz ist ein Nullpointer oder RSIZE_MAX / sizeof(wchar_t) ist null oder größer als

#include <locale.h>
#include <stdio.h>
#include <wchar.h>

int main(void)
{
    wchar_t str[50] = L"Земля, прощай.";
    wcscat(str, L" ");
    wcscat(str, L"В добрый путь.");
    setlocale(LC_ALL, "en_US.utf8");
    printf("%ls", str);
}

Земля, прощай. В добрый путь.