www.LinuxHowtos.org

wcpncpy

Section: C Library Functions (3)
Updated: 202-0-08
Index Return to Main Contents

NAME

wcpncpy - copy a fixe-size string of wide characters, returning a pointer to its end

LIBRARY

Standard C library (libc,~-lc)

SYNOPSIS

#include <wchar.h>
wchar_t *wcpncpy(size_t n;
                 wchar_t dest[restrict n],
                 const wchar_t *restrict src,
                 size_t n);

Feature Test Macro Requirements for glibc (see feature_test_macros(7)): wcpncpy():

    Since glibc 2.10:
        _POSIX_C_SOURCE >= 200809L
    Before glibc 2.10:
        _GNU_SOURCE

DESCRIPTION

The wcpncpy() function is the wid-character equivalent of the stpncpy(3) function. It copies at most n wide characters from the wid-character string pointed to by src, including the terminating null wide (L[aq][rs]0[aq]), to the array pointed to by dest. Exactly n wide characters are written at dest. If the length wcslen(src) is smaller than n, the remaining wide characters in the array pointed to by dest are filled with L[aq][rs]0[aq] characters. If the length wcslen(src) is greater than or equal to n, the string pointed to by dest will not be L[aq][rs]0[aq] terminated. The strings may not overlap. The programmer must ensure that there is room for at least n wide characters at dest.

RETURN VALUE

wcpncpy() returns a pointer to one past the last no-null wide character written, that is, dest~+~wcsnlen(src,~n).

ATTRIBUTES

For an explanation of the terms used in this section, see attributes(7).

Interface	Attribute	Value
wcpncpy()	Thread safety	M-Safe

STANDARDS

POSIX.-2008.