Namensräume
Varianten
Aktionen

std::wcsncat

Von cppreference.com
< cpp‎ | string‎ | wide
 
 
 
 
Definiert in Header <cwchar>
wchar_t* wcsncat( wchar_t* dest, const wchar_t* src, std::size_t count );

Hängt maximal count Weitzeichen vom String src an das Ende des Strings dest an, wobei der Vorgang stoppt, wenn das Nullterminierungszeichen kopiert wird. Das Weitzeichen src[0] ersetzt das Nullterminierungszeichen am Ende von dest. Das Nullterminierungszeichen wird immer am Ende angehängt (daher ist die maximale Anzahl von Weitzeichen, die die Funktion schreiben darf, count + 1).

Das Verhalten ist undefiniert, wenn das Zielarray nicht groß genug für den Inhalt von sowohl src als auch dest sowie das abschließende Nullterminierungszeichen ist.

Das Verhalten ist undefiniert, wenn sich die Zeichenketten überlappen.

Inhalt

[bearbeiten] Parameter

dest - Zeiger auf den nullterminierten Wide-String, an den angehängt werden soll
src - Zeiger auf den nullterminierten Wide-String, von dem kopiert werden soll
zählt - maximale Anzahl von zu kopierenden Zeichen

[bearbeiten] Rückgabewert

dest

[bearbeiten] Beispiel

#include <clocale>
#include <cwchar> 
#include <iostream>
 
int main(void) 
{
    wchar_t str[50] = L"Земля, прощай.";
    std::wcsncat(str, L" ", 1);
    std::wcsncat(str, L"В добрый путь.", 8); // only append the first 8 wide chars
 
    std::setlocale(LC_ALL, "en_US.utf8");
    std::wcout.imbue(std::locale("en_US.utf8"));
    std::wcout << str << '\n';
}

Mögliche Ausgabe

Земля, прощай. В добрый

[bearbeiten] Siehe auch

hängt eine Kopie einer breiten Zeichenkette an eine andere an
(Funktion) [bearbeiten]
verbindet eine bestimmte Anzahl von Zeichen von zwei Strings
(Funktion) [bearbeiten]
kopiert eine breite Zeichenkette in eine andere
(Funktion) [bearbeiten]
C-Dokumentation für wcsncat