strnset()

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

Synopsis:

#include <string.h>

char * strnset( char * s1, 
                int fill, 
                size_t len );

Library:

libc

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

Returns:

The address of the original string, s1.

Examples:

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

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

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

produces the output:

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

Classification:

QNX 4

See also:

strset()