uninset

Sets the specified number of characters in a string to a given character.

Library:LibC
Service:Characters and Strings

Syntax

  #include <unilib.h> 
   
  unicode_t *uninset (
     unicode_t   *base,
     unicode_t    ch
     size_t       n);

Parameters

base

(IN/OUT) Points to the array for the string to filled with the specified character.

ch

(IN) Specifies the character to be copied.

n

(IN) Specifies the number of times to copy the character into the string.

Return Values

Returns a pointer to the tgt parameter.

Remarks

The uninset function fills the tgt string with the value of the ch parameter, with the number of characters specified in the n parameter. When the value of n 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 ch character.

The uninset function corresponds to the strnset function.

See Also