strset()

Fill a string with a given character

Synopsis:

#include <string.h>

char* strset( char* s1, 
              int fill );

Arguments:

s1: The string that you want to fill.
fill: The value that you want to fill the string with.

Library:

libc

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

Description:

The strset() function fills the string pointed to by s1 with the character fill. The terminating null character in the original string remains unchanged.

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", strset( source, '=' ) );
    printf( "%s\n", strset( source, '*' ) );
    return EXIT_SUCCESS;
  }

produces the output:

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

Classification:

QNX 4

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