CKTIS / C
wcscpy — een wide-character-tekenreeks kopiëren
wcscpy kopieert een wchar_t-tekenreeks, inclusief het afsluitende teken. De doelbuffer moet groot genoeg zijn en de gekopieerde geheugengebieden mogen elkaar niet overlappen.
Versie: C23; repository compiler flag, production runtime not attested
Syntax
#include <wchar.h>
wchar_t *wcscpy(wchar_t * restrict s1, const wchar_t * restrict s2);wcscpy, gedeclareerd in <wchar.h>, kopieert de tekenreeks van s2 naar s1, inclusief de afsluitende L'\0'. De functie retourneert s1, niet de lengte van de kopie.
De bestemming moet schrijfbaar zijn en minstens wcslen(s2) + 1 elementen van het type wchar_t kunnen bevatten, geen bytes. De bron moet afgesloten zijn. Een te kleine buffer, ongeldige pointers of overlappende gekopieerde geheugengebieden veroorzaken ongedefinieerd gedrag.
De functie krijgt geen buffercapaciteit mee en voert geen conversie van tekencodering uit. Het voorbeeld reserveert ook ruimte voor het afsluitende teken; het geeft de lengte en het resultaat van de vergelijking van de geretourneerde pointer met dst weer.
Voorbeelden
#include <stdio.h>
#include <wchar.h>
int main(void)
{
const wchar_t src[] = L"Hello";
wchar_t dst[sizeof src / sizeof src[0]];
wchar_t *result = wcscpy(dst, src);
printf("length=%zu, same_pointer=%d\n",
wcslen(dst), result == dst);
return 0;
}Resultaat
length=5, same_pointer=1
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.