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 );

Arguments:

s1: The string that you want to fill.
fill: The value that you want to fill the string with.
len: The number of characters to fill.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

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

Safety:
Cancellation point	No
Interrupt handler	Yes
Signal handler	Yes
Thread	Yes