strnset, _mbsnset, _wcsnset

Nach oben zu string.h - Index

Header-Datei

string.h

Kategorie

Routinen für Speicher- und String-Bearbeitung, Inline-Routinen

Prototyp

char *strnset(char *s, int ch, size_t n);

wchar_t *_wcsnset(wchar_t *s, wchar_t ch, size_t n);

unsigned char *_mbsnset(unsigned char *s, unsigned int ch, size_t n);

Beschreibung

Setzt eine bestimmte Anzahl von Zeichen in einem String auf das angegebene Zeichen.

strnset kopiert das Zeichen ch in die ersten n Bytes des Strings s. Ist n > strlen(s), dann ersetzt strlen(s) den Wert von n. Der Vorgang wird beendet, wenn n Zeichen bearbeitet wurden oder ein Nullzeichen gefunden wird.

Rückgabewert

Jede dieser Funktionen gibt s zurück.

Beispiel

 #include <stdio.h>
 #include <string.h>
 int main(void)
 {
    char *string = "abcdefghijklmnopqrstuvwxyz";
    char letter = 'x';
    printf("string before strnset: %s\n", string);
    strnset(string, letter, 13);
    printf("string after  strnset: %s\n", string);
    return 0;
 }

Portabilität

	POSIX	Win32	ANSI C	ANSI C++
strnset		+
_mbsnset		+
_wcsnset		+