Syntax

  #include <string.h>  
   
  char *strnset  (  
     char    *s1,   
     int      fill,   
     size_t   len);
  

Parameters

s1

(OUT) Points to the string to be filled with the specified character.

fill

(IN) Specifies the character be copied.

len

(IN) Specifies the number of bytes into which the fill character is to be copied.

Return Values

The address of the original string s1 is returned.

Remarks

strnset 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 is set to the fill character.

See Also

memset, strset

Example

  #include <string.h>  
   
  char source[ ] = {"A sample STRING"};  
   
  main ()  
  {  
     printf ("%s\n", source);  
     printf ("%s\n", strnset (source, `=’, 100) );  
     printf ("%s\n", strnset (source, `*’, 7) );  
  }
  

produces the following:

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