_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);
 }