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 len );
char __far *_fstrnset( char __far *s1,
                       int fill,
                       size_t len );

Description:

The strnset() and _fstrnset() functions fill the string s1 with the value of the argument fill, converted to be a character value. When the value of len 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

See also:

strset()

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

Systems:

strnset()

All (except DOS/PM)

_fstrnset()

All (except Netware, DOS/PM)