strnset(), _fstrnset()

fill a string with a given character, to a given length

Synopsis:

#include <string.h>

char *strnset( char *s1, int fill, 
               size_t count );
char __far *_fstrnset( char __far *s1,
                       int fill,
                       size_t count );

Description:

The strnset() function fills the string s1 with the value of the argument fill, converted to be a character value. When the value of count is greater than the length of the string, the entire string is filled. Otherwise, that number of characters at the start of the string are set to the fill character.

The _fstrnset() function is a data-model-independent form of the strnset() function. It accepts far pointer arguments, and returns a far pointer. It is most useful in mixed memory model applications.

Returns:

The address of the original string s1.

Examples:

#include <stdio.h>
#include <string.h>

char source[] = { "A sample STRING" };

void main()
  {
    printf( "%s\n", source );
    printf( "%s\n", strnset( source, '=', 100 ) );
    printf( "%s\n", strnset( source, '*', 7 ) );
  }

produces the output:

A sample STRING
===============
*******========

Classification:

WATCOM

See also:

strset()