wcsncpy - Langzeichenteilkette kopieren

Definition

#include <wchar.h> wchar_t *wcsncpy(wchar_t *ws1, const wchar_t *ws2, size_t n); wcsncpy kopiert maximal n Zeichen der Langzeichenkette ws2 in den Speicherbereich, auf den ws1 zeigt. Zeichen, die dem Null-Langzeichen folgen, werden nicht kopiert. Wenn die Langzeichenkette ws2 weniger als n Zeichen enthält, wird nur in der Länge von ws2 (wcslen + 1) kopiert, ws1 wird dann bis zur Länge n mit Null-Langzeichen aufgefüllt. Wenn die Langzeichenkette ws2 n Zeichen (ohne das Null-Langzeichen) oder mehr enthält, ist die Langzeichenkette ws1 nicht automatisch mit dem Null-Langzeichen abgeschlossen. Wenn die Langzeichenkette ws1 mehr als n Zeichen enthält und das letzte kopierte Zeichen aus ws2 ist nicht das Null-Langzeichen, bleiben ggf. restliche Daten in ws1 erhalten. wcsncpy schließt ws1 nicht automatisch mit dem Null-Langzeichen ab.

Returnwert  Zeiger auf die Ergebnis-Langzeichenkette ws1.

Hinweise

In dieser Version des C-Laufzeitsystems werden nur 1-Byte-Zeichen als Langzeichen unterstützt. wcsncpy überprüft nicht, ob der Speicherbereich ws1 groß genug für das Ergebnis ist! Da wcsncpy die Ergebnis-Langzeichenkette nicht automatisch mit dem Null-Langzeichen abschließt, kann es häufig notwendig sein, ws1 explizit mit einem Null-Langzeichen abzuschließen. Das ist z.B. der Fall, wenn nur ein Teilstück aus ws2 kopiert wird und auch ws2 kein Null-Langzeichen enthält. Bei sich überlappenden Speicherbereichen ist das Verhalten undefiniert.

Siehe auch  strncpy, wcscpy