BEZEICHNUNG¶

wcsncpy - eine Zeichenkette weiter Zeichen fester Größe kopieren

BIBLIOTHEK¶

Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT¶

#include <wchar.h>

wchar_t *wcsncpy(wchar_t Ziel[restrict .n],
                 const wchar_t Quelle[restrict .n],
                 size_t n);

BESCHREIBUNG¶

Die Funktion wcsncpy() ist das Äquivalent der Funktion strncpy(3) für weite Zeichen. Sie kopiert höchstens n weite Zeichen von der Zeichenkette weiter Zeichen auf die Quelle zeigt, einschließlich des abschließenden weiten Nullzeichens (L'\0') in das Feld, auf das Ziel zeigt. Es werden genau n weite Zeichen nach Ziel geschrieben. Falls die Länge wcslen(Quelle) kleiner als n ist, dann werden die verbleibenden weiten Zeichen in dem Feld, auf das Ziel zeigt, mit weiten Nullzeichen gefüllt. Falls die Länge von wcslen(Quelle) größer oder gleich n ist, dann wird die Zeichenkette, auf die Ziel zeigt, nicht mit einem weiten Nullzeichen abgeschlossen.

Die Zeichenketten dürfen sich nicht überlappen.

Der Programmierer muss sicherstellen, dass es bei Ziel Raum für mindestens n weite Zeichen gibt.

RÜCKGABEWERT¶

wcsncpy() liefert Ziel zurück.

ATTRIBUTE¶

Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.

STANDARDS¶

C11, POSIX.1-2008.

GESCHICHTE¶

POSIX.1-2001, C99.

SIEHE AUCH¶

strncpy(3)

ÜBERSETZUNG¶

Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer.