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) Ajoute une copie de la chaîne large pointée par src à la fin de la chaîne large pointée par dest. Le caractère large src[0] remplace le terminateur nul à la fin de dest. La chaîne large résultante est terminée par null. Le comportement est indéfini si le tableau de destination n'est pas assez grand pour contenir le contenu de src et dest et le caractère large nul de terminaison. Le comportement est indéfini si les chaînes se chevauchent.

2) Identique à (1), sauf qu'il peut écraser le reste du tableau de destination (à partir du dernier caractère écrit dans destsz) avec des valeurs non spécifiées et que les erreurs suivantes sont détectées à l'exécution et appellent la fonction gestionnaire de contrainte actuellement installée :

• src ou dest est un pointeur nul
• destsz est zéro ou supérieur à RSIZE_MAX / sizeof(wchar_t)
• il n'y a pas de terminateur nul dans les destsz premiers caractères larges de dest
• une troncature se produirait (l'espace disponible à la fin de dest ne pourrait pas contenir chaque caractère large, y compris le terminateur nul, de src)
• un chevauchement se produirait entre la chaîne source et la chaîne de destination

Comme pour toutes les fonctions vérifiées par bornes, wcscat_s n'est garanti d'être disponible que si __STDC_LIB_EXT1__ est défini par l'implémentation et si l'utilisateur définit __STDC_WANT_LIB_EXT1__ comme la constante entière 1 avant d'inclure <wchar.h>.

1) renvoie une copie de dest

2) renvoie zéro en cas de succès, renvoie non nul en cas d'erreur. De plus, en cas d'erreur, écrit L'\0' dans dest[0] (sauf si dest est un pointeur nul ou destsz est zéro ou supérieur à RSIZE_MAX / sizeof(wchar_t)).

#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);
}

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