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.

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

See also:

strset()