Click above to get retro games delivered to your door ever month!

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 is returned.

See Also:
    strset, _fstrset

Example:
    #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 following:

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

Classification:
    WATCOM

Systems:
     strnset - All

    _fstrnset - All