_mbsnbset
Nach oben zu String.h - Index
Header-Datei
mbstring.h
Kategorie
Routinen für Speicher- und String-Bearbeitung
Prototyp
unsigned char *_mbsnbset(unsigned char str, unsigned int ch, size_t maxlen);
Beschreibung
_mbsnbset setzt höchstens maxlen Bytes im String str auf das Zeichen ch. Das Argument ch kann ein Einzel- oder ein Multibyte-Zeichen sein.
Die Funktion endet, wenn vor Erreichen von maxlen das terminierende Nullzeichen gefunden wird. Ist ch ein Multibyte-Zeichen, das am Ende von str nicht mehr untergebracht werden kann, wird als letztes Zeichen von str ein Leerzeichen eingesetzt.
Rückgabewert
_mbsnbset gibt einen Zeiger auf char zurück, den neuen mit dem Zeichen erstellten String.
Beispiel
#include <mbstring.h>
/* Erstellt einen neuen String, der mit dem angegebenen Zeichen
die angegebenen Male gefüllt wird.
*/
char* fill_string(unsigned int ch, size_t chars)
{
/* Länge des Strings festlegen (für MBCS: Zeichen * 2 Bytes) */
int str_len = (ch <= 0xff) ? chars : chars * 2;
/* Einen neuen String erstellen, der aus dem angegebenen Zeichen besteht */
return _mbsnbset((char*)malloc(str_len + 1), ch, str_len);
}