Scroll to navigation

wcpncpy(3) Library Functions Manual wcpncpy(3)

NAZWA

wcpncpy - kopiuje łańcuch szerokich znaków o ustalonej długości i zwraca wskaźnik do jego końca

BIBLIOTEKA

Standardowa biblioteka C (libc, -lc)

SKŁADNIA

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

Wymagane ustawienia makr biblioteki glibc (patrz feature_test_macros(7)):

wcpncpy():


Od glibc 2.10:
_POSIX_C_SOURCE >= 200809L
Przed glibc 2.10:
_GNU_SOURCE

OPIS

Funkcja wcpncpy() jest szerokoznakowym odpowiednikiem funkcji stpncpy(3). Kopiuje co najwyżej n znaków z łańcucha szerokich znaków wskazywanego przez src, łącznie z kończącym szerokim znakiem null (L'\0'), do tablicy wskazywanej przez dest. W dest zapisywanych jest dokładnie n szerokich znaków. Jeśli długość wcslen(src) jest mniejsza niż n, pozostałe znaki tablicy dest są wypełniane znakami L'\0'. Jeśli długość wcslen(src) jest większa lub równa n, to łańcuch w dest nie będzie zakończony znakiem L'\0'.

Łańcuchy nie mogą na siebie nachodzić.

Programista musi zapewnić, że będzie miejsce przynajmniej na n szerokich znaków w dest.

WARTOŚĆ ZWRACANA

wcpncpy() zwraca wskaźnik do ostatniego zapisanego szerokiego znaku, tj. dest+n-1.

ATRYBUTY

Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku attributes(7).

Interfejs Atrybut Wartość
wcpncpy() Bezpieczeństwo wątkowe MT-bezpieczne

STANDARDY

POSIX.1-2008.

ZOBACZ TAKŻE

stpncpy(3), wcsncpy(3)

TŁUMACZENIE

Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Przemek Borys <pborys@dione.ids.pl>, Robert Luberda <robert@debian.org> i Michał Kułach <michal.kulach@gmail.com>

Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.

Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej manpages-pl-list@lists.sourceforge.net.

2 maja 2024 r. Linux man-pages (niewydane)